Skip to content

Debian 12 Install

These instructions are for installing ASL3 on general purpose operating systems manually. For installation on Raspberry Pis, consider using the AllStarLink 3 Pi Appliance

Architecture Support

Currently, the project does not support armv7l/armhf platforms because all known uses of AllStarLink is on hardware which supports the Bookworm arm64 distribution such as Raspberry Pi 3, 4, 5, and Zero 2 W. If you have a platform that can use armv7l/armhf 32-bit packages only please file an issue at ASL3 on GitHub.

Previous Issues with Cloud Kernels

As of DAHDI Linux 3.4.0-5, as released from AllStarLink, no longer has conflicts with the Debian "cloud" kernels and is fully supported.

System Requirements

The following are the system requirements for an ASL3 system:

Minimum Required Recommended
CPU/Platform 1 CPU, 64-bit, x86_64 (amd64) or ArmV8 (arm64) 2 - 4 CPUs depending on the number of hardware devices connected to the system
Memory 512M 2 G
Storage 8G (for OS + software) -

UEFI / SecureBoot

For x86_64/amd64 platforms, it is recommended to disable SecureBoot if you do not need that feature. While it is a good security feature, given that AllStarLink v3 requires building a kernel module, it adds likely-undesired complexity for most ASL users. If you need or want to use UEFI/SecureBoot see the advanced topic document.

Debian 12 OS Install

You’re going to start off by installing a new Debian 12 OS on your PC computer or virtual machine. There are instructions all over the internet that detail how to install Debian 12. Briefly you:

  • Download and boot the Debian 12 netinstall.iso
  • Take most of the defaults
  • Do not install a Debian desktop environment
  • Do install web server (if you plan to use Allmon3 or other web management packages)
  • Do install SSH server

NOTE: When setting up users and passwords you may be prompted to set the password for the root account. If you DO NOT provide a password then the root account will be disabled, and the system's initial user account (that will requested on the next screen) will be given the power to become root using the sudo command. If you DO provide a password then the sudo command will NOT be installed on your system. Our recommendation is to NOT set the root password and rely on using the sudo command only when needed.

Once your Debian system is up and running, install the ASL package repositories:

cd /tmp
wget https://repo.allstarlink.org/public/asl-apt-repos.deb12_all.deb
sudo dpkg -i asl-apt-repos.deb12_all.deb
sudo apt update

ASL3 Packages Install

Now the packages may be installed and updated directly from the AllStarLink package repository:

sudo apt install asl3

This will install the complete ASL3 system including all of the Asterisk app_rpt-enabled packages (asl3-asterisk, asl3-asterisk-config, asl3-asterisk-doc, asl3-asterisk-modules), the Dahdi kernel module (dahdi-dkms, dahdi-linux, dahdi-source), the needed development tools to keep the kernel module updated, and the asl3-menu.

It's important to note that the new packaging format will allow for easy, automated updates of kernels through the standard apt upgrade process. There is no longer any reason to hold back kernel upgrades with the ASL3 packaging.

The following packages are also available and may be installed separately:

Allmon3 - The updated web interface to AllStarLink which includes strong support for mobile devices and screens of all sizes and shapes. See the Allmon3 page for details.

ASL3 Nodelist Updater - An updated node service to maintain a local copy of the AllStarLink node database (rpt_extnodes). While, in general, the preferred method of node lookup is DNS, some installations with slow Internet or DNS servers that have very long cache timers may benefit from this method of node lookup instead.

Install with sudo apt install asl3-update-nodelist.

Node Configuration

The next step is to configure the node settings. It is recommended to use the asl-menu command to manage the configuration for common use cases. See ASL3 Menu for details. YouTuber Freddie Mac has a nice ASL3 RPi installation and configuration video. See the part where the asl-menu is shown.

Proceed from here with the Node Settings option in order to configure your node number and choose/configure your audio interface.

Debian 12 Appliance

Do This at Your Own Risk

A Debian 12 Appliance, similar to the Raspberry Pi Appliance, is still under development. In the meantime, you can get "close" to the same user experience by installing and configuring some additional packages. This is not generally recommended for most users at this time.

If you install the following packages, you’ll have everything you need to use the “appliance” configuration:

sudo apt install asl3 asl3-update-nodelist asl3-menu allmon3

You will still need to do certain things like configure Allmon3 by hand.

If you want to turn your configuration you described into the full appliance, you can try installing asl3-pi-appliance which will “take over” your system.

This hasn't been rigorously tested against a non-Pi installation, but it should mostly work (if not completely work) - but YMMV. A non-PI “image” is in the works, but it’s not ready yet.

If you don’t want to take the risk of that, but still want all the web experience, you can install:

sudo apt install cockpit cockpit-networkmanager cockpit-packagekit \
  cockpit-sosreport cockpit-storaged cockpit-system cockpit-ws \
  python3-serial firewalld

Which should give you an unbranded, uncustomized Cockpit environment.

Again, doing the above is experimental and not generally recommended, but you are welcome to give it a try, and perhaps provide feedback on issues and changes to help push the development of a Debian 12 Appliance image along!

Docker

Docker support will be coming in the near future.