📟 Retro Mode

title: “APRS on Linux: Setting Up Dire Wolf and Xastir Across Distros”

author: “Joe Hallford (W4DXR)” date: 2026-10-27 categories: [“Amateur Radio”, “Linux”, “APRS”] tags: [“Dire Wolf”, “Xastir”, “APRS”, “Debian”, “Ubuntu”, “Arch Linux”, “Packet Radio”] description: “A comprehensive guide to configuring Dire Wolf as a software TNC and piping it into Xastir for APRS mapping on Linux.”

APRS on Linux: Setting Up Dire Wolf and Xastir

Building an Automatic Packet Reporting System (APRS) station on Linux is a fantastic way to handle local packet traffic, weather telemetry, and station mapping without relying on heavy or proprietary software suites.

By combining Dire Wolf (a software soundcard TNC and AFSK modem) with Xastir (the premier graphical APRS mapping client for UNIX-like systems), you get a high-performance packet workstation.

1. The Core Stack: Dire Wolf and Xastir

  • Dire Wolf: Acts as a virtual TNC (Terminal Node Controller). It takes audio from your receiver, decodes 144.390 MHz AFSK packets using advanced DSP algorithms, and can expose a standard KISS TNC over a local network port or pseudo-terminal.

  • Xastir: Connects to Dire Wolf to plot stations, weather reports, and object markers on raster or vector maps.

2. Installation Across Distributions

On Debian / Ubuntu

Dire Wolf and Xastir can be installed directly from standard repositories or compiled for the latest feature sets:

sudo apt update
sudo apt install direwolf xastir

On Arch Linux

Arch users can pull both applications from the Arch User Repository (AUR):

yay -S direwolf xastir

3. Common Distro Pitfalls and Troubleshooting

A. Audio Input Levels and Overmodulation

Dire Wolf is exceptionally sensitive to audio gain. If your input volume is set too high, the audio waveforms will clip, resulting in zero decodes and console warnings.

  • The Fix: Open alsamixer or pavucontrol in your terminal while receiving packets. Select your USB audio interface and lower your capture (microphone) volume until background static sits comfortably around the lower green bars, saving headroom for packet bursts.

B. Connecting Xastir to Dire Wolf via Network KISS TNC

Rather than wrestling with serial device routing, configure Dire Wolf to launch a network KISS TNC server in your direwolf.conf:

ADEVICE plughw:CARD=CODEC,DEV=0
KISSPORT 8001

Once Dire Wolf is running and decoding packets, open Xastir and configure a new interface:

  1. Go to Interface -> Interface Control -> Add.
  2. Select Network TCP and point it to localhost on port 8001.
  3. Enable the interface, and you will immediately see packets streaming into Xastir’s map window.

Conclusion

Running Dire Wolf and Xastir on Linux gives you a robust, lightweight APRS command center. By dialing in your ALSA soundcard capture levels and leveraging network KISS sockets, your packet station will run reliably across Debian, Ubuntu, and Arch.