fibex/asterisk repository overview

⁠Supported tags

• 13.28.1-alpine, 13-alpine, alpine, latest
• 16.5.1-alpine, 16-alpine

⁠What is Asterisk?

Asterisk is an open source framework for building communications applications. Asterisk turns an ordinary computer into a communications server. Asterisk powers IP PBX systems, VoIP gateways, conference servers and other custom solutions. It is used by small businesses, large businesses, call centers, carriers and government agencies, worldwide. Asterisk is free and open source. Asterisk is sponsored by Digium.

https://www.asterisk.org/get-started⁠

⁠How to use this image

$ docker run --net=host --name fbx-asterisk -v '/path/to/etc/asterisk:/etc/asterisk' --cap-add=sys_nice -d fibex/asterisk

The path /path/to/etc/asterisk stands for your asterisk configuration files.

⁠Volumes

The following volumes are also honored for your Asterisk instance:

• -v "asterisk_etc:/etc/asterisk" - main asterisk configuration files. If this directory is empty, the image will extract sample configuration files from asterisk distribution.
• -v "asterisk_moh:/var/lib/asterisk/moh" - music on hold files directory
• -v "asterisk_sounds:/var/lib/asterisk/sounds" - sounds (You can be download it here⁠ )
• -v "asterisk_monitor:/var/spool/asterisk/monitor" - default call recordings directory

⁠Environment variables

The following environment variables are also honored for configuring your Asterisk instance:

• -e DB_HOST=... (defaults to "db") IP or hostname of the database container
• -e DB_PORT=... (defaults to "3306" for MySQL and "5432" for PostgreSQL) Published port of database container
• -e DB_NAME=... (defaults to "asterisk") Database name
• -e DB_USERNAME=... (defaults to "root") Database user
• -e DB_PASSWORD=... (defaults to "example") Database password

⁠dockerize inside

You can use other environment variables in your configuration files in /etc and sub directories. The ENTRYPOINT of this image includes dockerize by Jason Wilder (https://github.com/jwilder/dockerize⁠).

It will generate application configuration files at container startup time from templates and container environment variables. Every file with extension .tmpl in /etc and sub-directories will be converted into files without this extension.

⁠docker-compose

Example docker-compose.yml for this Asterisk image:

version: "3.7"

services:

  asterisk:
    image: fibex/asterisk
    network_mode: "host"
    environment:
      - DB_HOST=db
      - DB_NAME=asterisk
      - DB_USERNAME=root
      - DB_PASSWORD=example
      - DB_PORT=3306
    volumes:
      - "/path/to/etc/asterisk/:/etc/asterisk/"
    cap_add:
     - SYS_NICE

  db:
    image: "mysql:5"
    environment:
      - MYSQL_ROOT_PASSWORD=example

⁠Database ODBC connector

This image was build with unixODBC with two connectors MariaDB Connector/ODBC 3.0 driver (x86_64 pre-build from https://github.com/MariaDB/mariadb-connector-odbc⁠) and PostgreSQL ODBC driver (Native Alpine package https://pkgs.alpinelinux.org/package/edge/main/x86_64/psqlodbc⁠). You can choose what to use by setting option dns in /etc/asterisk/res_odbc.conf:

• dsn => MySQL-connector - MySQL
• dsn => PostgreSQL-connector - PostgreSQL

⁠Asterisk modules

• format_mp3.so
• res_odbc.so
• cdr_adaptive_odbc.so
• chan_sip.so
• pbx_ael.so
• res_fax.so
• res_fax_spandsp.so
• chan_pjsip.so

No sounds or MOH included in this image.