Installation

Install the Package

Download the .rpm package for your architecture from the GitHub Releases page, then install it:

sudo dnf install ./graywolf_*.rpm

The package installs both binaries, creates the graywolf system user, and installs the systemd unit.

Start the Service

sudo systemctl enable --now graywolf

Install from AUR

# With an AUR helper (e.g., yay or paru)
yay -S graywolf-aprs

Or build manually:

git clone https://aur.archlinux.org/graywolf-aprs.git
cd graywolf-aprs
makepkg -si

The PKGBUILD builds both the Rust modem and Go binary from source, installs them to /usr/bin, and installs the systemd unit.

Start the Service

sudo systemctl enable --now graywolf-aprs

Run the Installer

Download the Windows installer (graywolf_<version>_Windows_x86_64.exe) from the GitHub Releases page and run it. Administrator rights are required so the installer can write to C:\Program Files and register an Add/Remove Programs entry. 64-bit Windows only.

The installer places:

• graywolf.exe and graywolf-modem.exe under C:\Program Files\Graywolf\
• The SQLite databases under C:\ProgramData\Graywolf\ (preserved across upgrades)
• A Start Menu shortcut that launches graywolf with the correct flags

Start Graywolf

Launch Graywolf from the Start Menu. A console window opens and the web UI binds to 127.0.0.1:8080.

Running as a Service (optional)

To run graywolf in the background and start it at boot, wrap it with NSSM:

choco install nssm

nssm install Graywolf "C:\Program Files\Graywolf\graywolf.exe" `
  -config "C:\ProgramData\Graywolf\graywolf.db" `
  -history-db "C:\ProgramData\Graywolf\graywolf-history.db" `
  -modem "C:\Program Files\Graywolf\graywolf-modem.exe" `
  -http 127.0.0.1:8080

nssm set Graywolf Start SERVICE_AUTO_START
nssm start Graywolf

Full instructions, including sc.exe as an alternative, live in packaging/nsis/RUNNING-AS-A-SERVICE.md.

Setting the Admin Password

The easiest way is through the web interface. With the service running, browse to http://localhost:8080. On first run — when no users exist yet — the login screen shows a Create Admin Account form. Enter a username and password there and you’re done; no command line needed.

If you prefer the command line, open a command prompt (or PowerShell) and run the command below. The auth subcommand must come first, before the -config flag:

"C:\Program Files\Graywolf\graywolf.exe" auth set-password --user admin ^
  -config "C:\ProgramData\Graywolf\graywolf.db"

You’ll be prompted to enter the password. The path is the same config database the service runs with (see the NSSM command above).

Container Image

ghcr.io/chrissnell/graywolf:latest

Docker Run

docker run -d \
  --name graywolf \
  --restart unless-stopped \
  --device /dev/snd \
  -p 8080:8080/tcp \
  -v graywolf-data:/data \
  ghcr.io/chrissnell/graywolf:latest \
  -config /data/graywolf.db -http 0.0.0.0:8080

Docker Compose

services:
  graywolf:
    image: ghcr.io/chrissnell/graywolf:latest
    container_name: graywolf
    restart: unless-stopped
    devices:
      - /dev/snd:/dev/snd
    ports:
      - "8080:8080/tcp"
    volumes:
      - graywolf-data:/data
    command: ["-config", "/data/graywolf.db", "-http", "0.0.0.0:8080"]

volumes:
  graywolf-data:

docker compose up -d

Exposing Additional Ports

If you plan to use KISS TCP or AGWPE, expose those ports as well:

ports:
  - "8080:8080/tcp"   # Web UI
  - "6700:6700/tcp"   # KISS TCP
  - "8000:8000/tcp"   # AGWPE

Requirements

• Rust toolchain (stable, via rustup)
• Go 1.22+
• Node.js 22+ and npm (for the web UI)
• GNU Make
• ALSA development headers (libasound2-dev on Debian/Ubuntu)

Build

git clone https://github.com/chrissnell/graywolf.git
cd graywolf

# Build everything (Rust modem + Svelte UI + Go binary)
make graywolf

The binaries are written to bin/graywolf and bin/graywolf-modem.

Cross-Compiling for ARM

To build for Raspberry Pi (aarch64), use cross:

cargo install cross

cross build --release --target aarch64-unknown-linux-gnu \
  -p graywolf-modem

Install System-Wide

The repository includes a systemd unit, postinstall script, and preremove script under packaging/. To install manually from a source build:

# Install binaries
sudo install -m 755 bin/graywolf /usr/bin/graywolf
sudo install -m 755 bin/graywolf-modem /usr/bin/graywolf-modem

# Install the systemd unit
sudo install -m 644 packaging/systemd/graywolf.service \
  /etc/systemd/system/graywolf.service

# Run the postinstall script (creates user, enables service)
sudo packaging/scripts/postinstall.sh

Then start the service:

sudo systemctl start graywolf

Makefile Targets