Introduction
Here is everything you need to setup developing for the add-on.
Architecture
The Asterisk add-on is a docker container for Home Assistant that set's up a Asterisk server and configures it to use with the card.
It does some extra things besides just running Asterisk.
- Ingress setup
- Preconfigured WebRTC endpoints
- Preconfigured AMI user
- Preinstalled modules like google tts
- And more...
How to Test
You can test the add-on on your Home Assistant to make sure it works.
- Comment out the
image
option inconfig.yaml
.
config.yaml
name: Asterisk
version: 1.3.2
slug: asterisk
description: PBX server for SIP devices like doorbells and phones
url: https://github.com/TECH7Fox/Asterisk-add-on
#image: "ghcr.io/tech7fox/{arch}-addon-asterisk"
arch:
- armhf
- armv7
- aarch64
- amd64
- i386
- Copy the
Asterisk
folder to/addons
. - Reload the repositories and install the add-on.
Running locally with Docker
The repository contains a docker-compose.yml
file that can be used to locally build and run a standalone version of the add-on.
- Copy the example
json
configuration file and set your own values:cp asterisk/config.json.example asterisk/config.json
- Build a Docker image:
docker-compose build asterisk
- Run the built image:
docker-compose up asterisk
- If you want to easily edit and test the scripts without having to rebuild the whole image, you can mount the local files from the project directory in the container.
See the
volumes:
section for examples.