Skip to main content

Asterisk Add-on

The Asterisk add-on is a PBX server that will handle the SIP devices and calls. It is made for the card and comes preconfigured.

Add the Repository

First install the add-on repository.

Now the add-on should show up under Asterisk Add-on.

Installation

Go to the Asterisk add-on, and click install. This can take around 1-3 minutes.

When the add-on is installed, we will need to configure it.

For this tutorial, we will set auto_generate on. Set a secure password for the AMI and generated extensions. We will need these later for the card and integration.

add-on configuration
ami_password: my-secret-password    # Set a secure password
auto_add_secret: my-secret-password # Set a secure password
video_support: false # Highly experimental, leave this off for this tutorial
auto_add: true # Generate a preconfigured PJSIP extension for every person entity
generate_ssl_cert: false # Enable this if you don't use something like duckdns
certfile: fullchain.pem
keyfile: privkey.pem
log_level: info

# These settings are optional
mailbox: false
mailbox_port: 12345
mailbox_extension: '100'
mailbox_password: my-secure-password
mailbox_google_api_key: my-google-stt-key

Start the add-on

Now we can start the add-on. After 1-3 minutes you can see the config files for Asterisk.

warning

The add-on uses ingress to tunnel the WebSocket connection to the card without the need for SSL or port forwarding. The OPEN WEB UI button will show a empty page, which is expected.

Understanding the Configuration

If you want to change Asterisk's settings, it's important to know how the add-on handles the configuration files. Please read the add-on documentation for more information.

tip

You can check the generated extensions in /addon_configs/3e533915_asterisk/asterisk/default/pjsip_default.conf.