This will build a container for FreePBX - A Voice over IP Manager for Asterisk. Upon starting this image it will give you a turn-key PBX system for SIP calling.
This Container uses tiredofit/debian:stretch as a base.
If you are presently running this image when it utilized FreePBX 14 and Asterisk 14 and can no longer use your image, please see this post
This image assumes that you are using a reverse proxy such as jwilder/nginx-proxy and optionally the Let's Encrypt Proxy Companion @ https://github.com/JrCs/docker-letsencrypt-nginx-proxy-companion in order to serve your pages. However, it will run just fine on it's own if you map appropriate ports.
You will also need an external MySQL/MariaDB Container, athough it can use an internally provided service (not recommended).
Automated builds of the image are available on Docker Hub and is the recommended method of installation.
docker pull tiredofit/freepbx:(imagetag)
The following image tags are available:
15 - Asterisk 16, Freepbx 15 - Debian Stretch (latest build)14 - Asterisk 14, Freepbx 14 - Debian Stretch (latest build)latest - Asterisk 16, Freepbx 15 - Debian Stretch (Same as 15)You can also visit the image tags section on Docker hub to pull a version that follows the CHANGELOG.
The quickest way to get started is using docker-compose. See the examples folder for a working docker-compose.yml that can be modified for development or production use.
Set various environment variables to understand the capabilities of this image.
Map persistent storage for access to configuration and data files for backup.
Make networking ports available for public access if necessary
The first boot can take from 3 minutes - 30 minutes depending on your internet connection as there is a considerable amount of downloading to do!
Login to the web server and enter in your admin username, admin password, and email address and start configuring the system!
The container supports data persistence and during Dockerfile Build creates symbolic links for /var/lib/asterisk, /var/spool/asterisk, /home/asterisk, and /etc/asterisk. Upon startup configuration files are copied and generated to support portability.
The following directories are used for configuration and can be mapped for persistent storage.
| Directory | Description |
|---|---|
/certs | Drop your Certificates here for TLS w/PJSIP / UCP / HTTPd/ FOP |
/var/www/html | FreePBX web files |
/var/log/ | Apache, Asterisk and FreePBX Log Files |
/data | Data Persistence for Asterisk and Freepbx and FOP |
/assets/custom | OPTIONAL - If you would like to overwrite some files in the container, put them here following the same folder structure for anything underneath the /var/www/html directory |
Along with the Environment Variables from the Base image, below is the complete list of available options that can be used to customize your installation.
| Parameter | Description |
|---|---|
ADMIN_DIRECTORY | What folder to access admin panel - Default /admin |
DB_EMBEDDED | Allows you to use an internally provided MariaDB Server e.g. TRUE or FALSE |
DB_HOST | Host or container name of MySQL Server e.g. freepbx-db |
DB_PORT | MySQL Port - Default 3306 |
DB_NAME | MySQL Database name e.g. asterisk |
DB_USER | MySQL Username for above Database e.g. asterisk |
DB_PASS | MySQL Password for above Database e.g. password |
ENABLE_FAIL2BAN | Enable Fail2ban to block the bad guys - Default TRUE |
ENABLE_FOP | Enable Flash Operator Panel - Default TRUE |
ENABLE_SSL | Enable HTTPd to serve SSL requests - Default FALSE |
ENABLE_XMPP | Enable XMPP Module with MongoDB - Default FALSE |
HTTP_PORT | HTTP Listening Port - Default 80 |
HTTPS_PORT | HTTPS Listening Port - Default 443 |
FOP_DIRECTORY | What folder to access FOP - Default /fop |
RTP_START | What port to start RTP Transmissions - Default 18000 |
RTP_FINISH | What port to start RTP Transmissions - Default 20000 |
UCP_FIRST | Load UCP as web frontpage TRUE/FALSE - Default TRUE |
TLS_CERT | TLS Certificate to drop in /certs for HTTPS if no reverse proxy |
TLS_KEY | TLS Key to drop in /certs for HTTPS if no reverse proxy |
WEBROOT | If you wish to install to a subfolder use this. Example: /var/www/html/pbx Default '/var/www/html' |
ADMIN_DIRECTORY and FOP_DIRECTORY may not work correctly if WEBROOT is changed or UCP_FIRST=FALSE
The following ports are exposed.
| Port | Description |
|---|---|
80 | HTTP |
443 | HTTPS |
4445 | FOP |
4569 | IAX |
5060 | PJSIP |
5160 | SIP |
8001 | UCP |
8003 | UCP SSL |
8008 | UCP |
8009 | UCP SSL |
18000-20000/udp | RTP Ports |
upgrade-cdr, which will download the latest CDR module, apply a tweak, install, and reload the system for you.SQLSTATE[22001]: String data, right truncated: 1406 Data too long for column 'helptext' at row 1. To resolve login to your SQL server and issue this statement: alter table featurecodes modify column helptext varchar(500);upgrade-core which will truncate the column and auto upgrade the core and framework modules.For debugging and maintenance purposes you may want access the containers shell.
docker exec -it (whatever your container name is e.g. freepbx) bash
Content type
Image
Digest
Size
559.1 MB
Last updated
almost 7 years ago
docker pull aasaidane/freepbx