Modern Docker images for Asterisk PBX with automated builds and optimized configurations.

📝 Legacy Code: Original code preserved in the legacy branch.

As defined in asterisk/supported-asterisk-builds.yml:

• Debian Trixie (AMD64)
• Debian Bookworm (AMD64)

• Debian Trixie (AMD64)

More versions and distributions coming soon!

• 🔄 Automated Release Discovery: Daily discovery of new Asterisk releases
• 📋 YAML-Driven Configuration: Template-based build system
• 🏗️ Multi-Stage Builds: Optimized production-ready images
• 🗄️ Database Integration: Full PostgreSQL and MySQL support
• 🌐 Modern Features: WebSocket, ARI, WebRTC, and comprehensive telephony features
• 📦 Multi-Platform Ready: ARM64 and AMD64 architecture support
• 🔧 Template System: Jinja2-based Dockerfile generation
• 🧪 Automated Testing: Health checks and functionality validation

Complete setup examples are available in the examples/ directory:

A ready-to-use Docker Compose configuration with:

• Production-ready Asterisk container with SIP/RTP port configuration
• Custom configuration templates including PJSIP setup
• Development overrides for local testing and debugging
• Volume management for logs and configuration persistence

cd examples/basic/
cp docker-compose.override.yml.template docker-compose.override.yml
docker compose up -d

The basic example demonstrates proper containerization patterns and provides a starting point for production deployments.

• Template-Based: All builds generated from YAML templates
• Version Discovery: Automatic detection of new Asterisk releases
• Multi-Stage Optimization: Separate builder and runtime environments
• Package Management: Distribution-specific dependency resolution
• Health Monitoring: Comprehensive container health checks

.
├── asterisk/                    # Build artifacts (auto-generated)
├── configs/                     # YAML configurations
├── templates/                   # Build templates
│   ├── debian-trixie.yml.template
│   ├── debian-bookworm.yml.template
│   └── dockerfile/              # Jinja2 templates
├── scripts/                     # Build automation
│   ├── build-asterisk.sh       # Main build interface
│   ├── discover-latest-versions.sh
│   └── generate-dockerfile.py
├── lib/                         # Python libraries
└── schema/                      # Validation schemas

The system automatically:

• 🔍 Scans for new Asterisk releases
• 📝 Updates build matrices
• ⚙️ Generates configurations for new versions
• 🚀 Triggers builds via GitHub Actions

• discover-releases.yml: Daily release discovery (20:00 UTC)
• build-images.yml: Automated multi-platform builds

While focus is on modern optimized versions, the repository maintains compatibility with all the Asterisk versions starting from 1.2, incluging LTS and Certified releases.

All modifications must be made through templates:

# Edit template (ONLY way to make changes)
vim templates/debian-trixie.yml.template

# Regenerate with --force-config
./scripts/build-asterisk.sh 22.5.2 --force-config

# Test build
docker build -t test asterisk/22.5.2-trixie/

# Discover new releases
./scripts/discover-latest-versions.sh --output-yaml --updates-only

# Build newly discovered versions
./scripts/build-asterisk.sh NEW_VERSION

# Build Asterisk 22.5.2 on Debian Trixie
./scripts/build-asterisk.sh 22.5.2

# Build specific OS variant
./scripts/build-asterisk.sh 22.5.2 debian bookworm

# Preview what would be built
./scripts/build-asterisk.sh 23.0.0-rc1 --dry-run

# Run latest optimized build
docker run --rm -p 5060:5060/udp asterisk:22.5.2_debian-trixie

# Check Asterisk version
docker run --rm asterisk:22.5.2_debian-trixie asterisk -V

• ✅ Modern Asterisk versions
• ✅ Multi-stage build optimization
• ✅ Automated release discovery

• 🔄 Alpine Linux support
• 🔄 ARM64 architecture builds
• 🔄 Additional LTS versions (18.x, 20.x)

Contributions are welcome! The new system is designed for maintainability:

1. Template Changes: Modify templates in templates/ directory
2. New Features: Extend YAML schema and build logic
3. Version Support: Add new OS/distribution combinations
4. Testing: Enhance validation and health checks

# Test template changes
./scripts/build-asterisk.sh VERSION --force-config --verbose

# Validate configurations
python3 scripts/generate-dockerfile.py CONFIG.yml --validate

# Test health checks
docker run --rm IMAGE /usr/local/bin/healthcheck.sh --verbose

If you were using the original andrius/asterisk images:

• Old: andrius/asterisk:latest
• New: andrius/asterisk:22.5.2_debian-trixie

• Old: Manual Dockerfile edits
• New: YAML-based configuration system

• Enhanced: Modern Asterisk features (WebRTC, ARI, PJSIP)
• Optimized: ~232MB production images vs ~6GB legacy
• Automated: Continuous updates and security patches

• 🐛 Issues: Report bugs via GitHub Issues
• 💬 Discussions: Community support and questions
• 📖 Documentation: Detailed guides in the repository
• 🏛️ Legacy: Reference implementations in legacy branch

Status: 🚧 Active Development - Revitalizing abandoned repository with modern automation