dave0073/asterisk repository overview

⁠This Docker image provides a pre-configured Asterisk VoIP server, ideal for home use.

It includes automated scripts to set up extensions and integrate with a VoIP provider, making it easy to get your home phone system up and running only nine extensions.

⁠Features

Pre-configured Asterisk Server: Get started with Asterisk without complex initial setup. Automated Extension Configuration: Easily add and manage extensions using provided scripts. VoIP Provider Integration: Seamlessly connect to your VoIP provider for making and receiving calls. Basic Contact Availability Check: Simple functionality to check the availability of contacts.

⁠How to Use

⁠Step 1: Pull the Docker Image

docker pull dave0073/asterisk:latest

⁠Step 2: Run the Docker Container

docker run -d --name asterisk-voip -p 5060:5060/udp -p 5061:5061/tcp -p 10000-10009:10000-10009/udp dave0073/asterisk

⁠Step 3: Configure Extensions

Use the provided script to add new extensions to your Asterisk server. The script requires three arguments for each extension: extension number, password, and alias (name).

docker exec -it asterisk-voip /bin/bash /scripts/configurar_asterisk.sh 100 mypassword "John Doe" 101 mypassword "Jane Smith"

⁠Step 4: Integrate with Your VoIP Provider

Use the provided script to configure your VoIP provider. You will need to provide your VoIP username, password, and server address.

docker exec -it asterisk-voip /bin/bash /scripts/configurar_voip_con_extensiones.sh your_voip_username your_voip_password your_voip_server

⁠Files and Directories

• /etc/asterisk/sip.conf: Configuration file for SIP settings.
• /etc/asterisk/extensions.conf: Configuration file for dial plan and extensions.
• /scripts/configurar_asterisk.sh: Script to add and configure extensions.
• /scripts/configurar_voip_con_extensiones.sh: Script to configure VoIP provider and integrate with extensions.

⁠Example Usage

To add extensions and configure the VoIP provider in one go, you can use the following commands after running the Docker container:

⁠Add extensions

docker exec -it asterisk-voip /bin/bash /scripts/configurar_asterisk.sh 100 secret100 "John Doe" 101 secret101 "Jane Smith"

⁠Configure VoIP provider

docker exec -it asterisk-voip /bin/bash /scripts/configurar_voip_con_extensiones.sh your_voip_username your_voip_password your_voip_server

⁠Ports

• 5060/udp: Standard SIP port.
• 5061/tcp: SIP over TLS.
• 10000-10009/udp: RTP ports for media streams.

Contributing Feel free to submit issues and pull requests. For major changes, please open an issue first to discuss what you would like to change.

docker exec -it asterisk-voip /bin/bash /scripts/configurar_asterisk.sh 100 mypassword "John Doe" 101 mypassword "Jane Smith"

⁠Step 4: Integrate with Your VoIP Provider

Use the provided script to configure your VoIP provider. You will need to provide your VoIP username, password, and server address.

docker exec -it asterisk-voip /bin/bash /scripts/configurar_voip_con_extensiones.sh your_voip_username your_voip_password your_voip_server

⁠Files and Directories

• /etc/asterisk/sip.conf: Configuration file for SIP settings.
• /etc/asterisk/extensions.conf: Configuration file for dial plan and extensions.
• /scripts/configurar_asterisk.sh: Script to add and configure extensions.
• /scripts/configurar_voip_con_extensiones.sh: Script to configure VoIP provider and integrate with extensions.

⁠Example Usage

To add extensions and configure the VoIP provider in one go, you can use the following commands after running the Docker container:

⁠Add extensions

docker exec -it asterisk-voip /bin/bash /scripts/configurar_asterisk.sh 100 secret100 "John Doe" 101 secret101 "Jane Smith"

⁠Configure VoIP provider

docker exec -it asterisk-voip /bin/bash /scripts/configurar_voip_con_extensiones.sh your_voip_username your_voip_password your_voip_server

⁠Ports

• 5060/udp: Standard SIP port.
• 5061/tcp: SIP over TLS.
• 10000-10009/udp: RTP ports for media streams.

Contributing Feel free to submit issues and pull requests. For major changes, please open an issue first to discuss what you would like to change.