Skip to content

Debian / Ubuntu Package

Port note: ASL3 already runs Apache2 on port 80. YAAMon defaults to port 8080 to avoid the conflict. Access it at http://<your-node-ip>:8080/ (or http://nodeXXXXX.local:8080/). See web server configuration if you want a different port or to front it with Apache.

Adding the YAAMon APT repository lets you install and upgrade with standard apt commands.

1. Install the signing key

curl -fsSL https://yaamon.n2vlv.net/debian/gpg.key \
  | sudo gpg --no-default-keyring \
      --keyring gnupg-ring:/usr/share/keyrings/yaamon-archive-keyring.gpg \
      --import
sudo chmod 644 /usr/share/keyrings/yaamon-archive-keyring.gpg

2. Add the repository

echo "deb [signed-by=/usr/share/keyrings/yaamon-archive-keyring.gpg] https://yaamon.n2vlv.net/debian stable main" \
  | sudo tee /etc/apt/sources.list.d/yaamon.list > /dev/null

3. Install

sudo apt update
sudo apt install yaamon

Upgrading

sudo apt update && sudo apt upgrade yaamon

Manual download and install

Download the .deb for your architecture from the Releases page:

Platform File
Raspberry Pi 3B+ / Zero 2 W / Pi 4 / Pi 5 yaamon_*_arm64.deb
x86-64 server / VM yaamon_*_amd64.deb 
# Example — replace version and arch as appropriate
wget https://github.com/jchonig/allstar-yaamon/releases/download/v0.4.3/yaamon_0.4.3_arm64.deb
sudo dpkg -i yaamon_0.4.3_arm64.deb

The package installs: - /usr/local/bin/yaamon — the binary - /lib/systemd/system/yaamon.service — systemd unit - /etc/yaamon/config.yaml — starter configuration (not overwritten on upgrade)

The service starts automatically on install.

Verify

sudo systemctl status yaamon
sudo journalctl -u yaamon -f

Systemd quick reference

sudo systemctl start yaamon
sudo systemctl stop yaamon
sudo systemctl restart yaamon
sudo systemctl status yaamon
sudo journalctl -u yaamon -f          # live logs
sudo journalctl -u yaamon --since today

Configuration

Edit /etc/yaamon/config.yaml then restart:

sudo systemctl restart yaamon

See Configuration for all available settings.