Run Pat with Docker Compose

The purpose of this repository is to serve as a building block for a containerized Winlink station, deployed using Docker Compose.

The primary benefit of such a deployment is the packaging and isolation of required software components, so they can run independent of the host's operating system and system libraries. Docker Compose also handles orchestration, making it easier to control the life-cycle of the applications.

Available services

• pat (Winlink client)
• ardopcf (ARDOP modem)
• direwolf (Packet modem)
• varahf (VARA HF modem, propriatery)
• varafm (VARA FM modem, propriatery)
• rigctld (Rig control)

Requirements

• Docker + Docker Compose
• Linux is recommended when using software modems

Quick start guide

Starting and stopping services

# Start Pat and ARDOP (in detached/background mode)
docker-compose up -d pat ardop

# Stream log output of all running containers
docker-compose logs -f

# Print status of all running/stopped containers
docker-compose ps -a

# Stop running containers
docker-compose stop

Run docker-compose help for more details.

Updating images (app installations)

# Pull hosted images (i.e. Pat)
docker-compose pull

# Re-build unhosted images (from source)
docker-compose build

Configuration

Edit docker-compose.yml to suite your needs. As a bare minimum you should set the environment variables PAT_MYCALL and PAT_LOCATOR, and possibly DEVNAME to specify which soundcard to use with ardopc/direwolf/vara.

The compose file also provides an example for rigctld, configured in Pat as a rig named "dummy". You'll probably want to rename it, change the command arguments to match your hardware, and add a devices section to mount the correct tty device.