FusionPBX Docker

A comprehensive Docker solution for FusionPBX, providing a complete VoIP platform with all necessary components pre-configured and ready to deploy.

Stack: Ubuntu 20.04 • FusionPBX 5.2 • FreeSWITCH 1.10.9 • PHP 7.4 • PostgreSQL 12

📚 References

FusionPBX Install Scripts: github.com/fusionpbx/fusionpbx-install.sh
Docker Hub Repository: hub.docker.com/repository/docker/michaelfangtw/fusionpbx-docker-dev

🏗️ Software Stack

Component	Version
Base OS	Ubuntu 20.04
FusionPBX	5.2
FreeSWITCH	1.10.9
PHP	7.4
PostgreSQL	12

� Included Services

The Docker image includes the following pre-configured services:

iptables - Firewall management
sngrep - SIP packet capture tool
fusionpbx - Web-based PBX system
php - PHP runtime
nginx - Web server
postgres - Database server
freeswitch - Voice over IP platform
fail2ban - Intrusion prevention system

🚀 Quick Start

Step 1: Configure Permissions

Set the proper ownership for the config directory:

sudo chown 33:33 config -R

💡 Note: The src directory contains the complete FusionPBX installer source code, allowing for customization and transparency in the build process.

Step 2: Choose Your Deployment Method

Option A: Use Pre-built Image (Recommended)

Pull the latest image from Docker Hub:

docker pull michaelfangtw/fusionpbx-docker-dev:5.2

Option B: Build Locally

If you want to build the image locally: you can change password in config.sh

docker build -t fusionpbx-docker-dev:5.2 .

Step 3: Configure Docker Compose

The docker-compose.yaml file is already configured. Choose your preferred method:

1. Pre-built image (default): Uses michaelfangtw/fusionpbx-docker-dev:5.2
1. Local build: Uncomment the build section in the compose file

services:
  pbx:
    # 1. Use pre-built image from Docker Hub
    image: michaelfangtw/fusionpbx-docker-dev:5.2
    
    # 2. Or build locally (uncomment to use)
    # build:
    #   context: .
    # 3. Or build locally (uncomment to use)
    # image: fusionpbx-docker-dev:5.2
    
    # Host networking for RTP port range
    network_mode: "host"
    container_name: fusionpbx
    restart: always
    privileged: true

    # Persist configuration
    volumes:
      - ./config/fusionpbx:/etc/fusionpbx

    entrypoint: ["/usr/sbin/init"]

Step 4: Start the Container

docker compose up -d

Step 5: Access the Web Interface

Once the container is running, access FusionPBX at:

URL: http://localhost
Username: admin@localhost
**vi **: password * dont forget to change password *

📁 Project Structure

fusionpbx-docker-dev/
├── config/                    # Configuration files
│   └── fusionpbx/            # FusionPBX configuration
├── src/                      # Source code and installers
│   └── fusionpbx-install.sh/ # Official FusionPBX installer scripts
│       ├── centos/           # CentOS installation scripts
│       ├── debian/           # Debian installation scripts
│       ├── devuan/           # Devuan installation scripts
│       ├── freebsd/          # FreeBSD installation scripts
│       ├── ubuntu/           # Ubuntu installation scripts
│       └── windows/          # Windows installation scripts
├── docker-compose.yaml       # Docker Compose configuration
├── Dockerfile               # Docker image definition
└── README.md               # Documentation

📝 Note: The src/fusionpbx-install.sh directory contains the complete official installer with platform-specific scripts and resources for various operating systems.

🔐 Default Credentials

🌐 Web Interface

URL: http://localhost
Username: admin@localhost
Password: password * dont forget to change password *

🗄️ Database (PostgreSQL)

⚠️ IMPORTANT: Do not change these credentials - they are required for proper operation

Host: localhost
User: fusionpbx
Password: password * don't forget to change your password *

🌐 Network Configuration

This container uses host networking mode to properly handle RTP traffic for VoIP communications. This means:

All services are accessible on the host's network interface
No port mapping is required
FreeSWITCH can properly handle media streams

💾 Data Persistence

Configuration data is persisted through Docker volumes:

Host Path	Container Path	Description
`./config/fusionpbx`	`/etc/fusionpbx`	FusionPBX configuration files

⚙️ Requirements

Docker Engine: 20.10+
Docker Compose: v2.0+
Operating System: Linux (required for host networking mode)

🔧 Troubleshooting

🌐 Web Interface Issues

Problem: Cannot Access Web Interface

If you can't access the web interface at http://localhost:

Check container status:
```
docker ps
```
View container logs:
```
docker logs fusionpbx
```
Check port availability:
```
sudo netstat -tulpn | grep :80
```

Problem: Login Issues

If you cannot log in to the web interface:

Access the container:
```
docker exec -it fusionpbx /bin/bash
```

Backup existing configuration:

mv /etc/fusionpbx/config.conf /etc/fusionpbx/config.conf.old

Reset admin credentials:

http://localhost
1.reset admin
  id=admin 
  pass=password  * don't forget to change your password *
  domain:localhost

  postgresq
  db host:localhost
  port:5432
  id=fusionpbx
  pass=password   * don't forget to change your password *

Use default credentials:
- Username: admin
- Password: password * don't forget to change your password *

🗄️ Database Issues

Problem: Database Connection Failures

If you encounter database-related login failures:

Access the container:
```
docker exec -it fusionpbx /bin/bash
```

Navigate to resources directory:

cd /src/fusionpbx-install.sh/ubuntu/resources

Recreate the database:

./postgresql.sh    # Create database
./finish.sh        # Set admin credentials

🐳 Container Management

Save Changes to Local Image

To preserve modifications made inside the container:

# Make changes inside the container
docker exec -it fusionpbx /bin/bash
# ... perform your modifications ...
# Exit the container

# Commit changes to create a new image
TAG=5.2
docker tag fusionpbx-docker:$TAG  michaelfangtw/fusionpbx-docker:$TAG
docker login
docker push michaelfangtw/fusionpbx-docker:$TAG

View Container Logs

# Real-time logs
docker logs -f fusionpbx

# Last 100 lines
docker logs --tail 100 fusionpbx

Restart Container

docker restart fusionpbx

📚 Additional Resources

🤝 Contributing

This project includes the complete FusionPBX installer source code in the src/ directory for transparency and customization. Feel free to submit issues and pull requests.

📄 License

This project follows the same licensing as the original FusionPBX project. Please refer to the official FusionPBX repository for license details.

Name		Name	Last commit message	Last commit date
config/fusionpbx		config/fusionpbx
.gitignore		.gitignore
Dockerfile		Dockerfile
README.md		README.md
build.sh		build.sh
compose.sh		compose.sh
config.sh		config.sh
docker-compose.yaml		docker-compose.yaml
push.sh		push.sh

Latest commit

History

Folders and files

Repository files navigation