Build-a-Pi will allow you to get up and running fast with a Raspberry Pi for ham radio.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
KM4ACK 42bf1a123f
Merge pull request #411 from km4ack/beta
4 months ago
conky fix #334 11 months ago
functions fix #404 4 months ago
patch remove patch 9 months ago
.complete General Formatting and Syntax. Fixed a few dangerous rm statments too. 2 years ago
.funfacts General Formatting and Syntax. Fixed a few dangerous rm statments too. 2 years ago
.gitignore Add gitignore for vscode 2 years ago update 7 months ago
app-check fix 373 8 months ago
bap-wallpaper.jpg initial 2 years ago
build-a-pi fix cqrlog 4 months ago
changelog update 4 months ago
diagnostic update Pat config path 11 months ago
logo.png update 2 years ago
menu-update update link 6 months ago
patch-menu remove echo command 1 year ago
update fix #380 6 months ago


Build-a-Pi will allow you to get up and running fast with a Raspberry Pi for ham radio. Rather than downloading a pre-built image where you have no choices in the build, Build-a- Pi gives you complete control over the build. It allows you to choose the applications you want to install and skip the ones you don’t need. This keeps your pi as lean and mean as possible. A list of applications available using Build-a-Pi can be found below on this page. Use it as your base and add additional applications as needed down the road.

Needed info for pi build

During the install you will need a few pieces of information depending on what you choose to install. If installing all apps, you will need:

For Hotspot: Current WiFi SSID & Current WiFi Password

For Pat Winlink: Winlink Password & Grid Square


Use Raspberry Pi Imager to download and flash your micro SD card. Once complete, put the SD card into the pi.

Power up your Raspberry Pi, login, open the terminal, and run the following command.

 git clone \
  $HOME/pi-build && bash $HOME/pi-build/build-a-pi

Additional help can be found in the video below.



Issue Reporting - Feature Requests

Please report issues & feature requests here:


Build-a-Pi has never, and will never, try to force any user to run BOINC (Berkeley Open Infrastructure for Network Computing). Build-a-Pi has always been about giving the end-user a choice in the software they run. It's also the reason Build-a-Pi isn't distrubuted as a pre-built image. You have the final say in what you run on your RPi. Install as little, or as much, as you choose. While it doesn't include as many apps as some of the pre-built images, Build-a-Pi should give you a great base to work with, then you can add additional applications that may be important to you on top. Want to run BOINC? Feel free because freedom is the basis of Build-a-Pi. The power is yours and yours alone.

Available Apps to Install

RTC | Real Time Clock

Software for DS3231 real-time clock (Available through update script after initial install)


Hotspot is used to generate a wifi hotspot that you can connect-to with other wireless devices. This is useful in the field, so you can connect-to and contol the RPi from a wireless device.

If enabled, the hotspot will only activate IF the RPi is not already connected to a wireless network. The hotspot will either activate at bootup, OR a maximum of 5 minutes AFTER you have forcefully disconnected from a wireless network. You can tune that detection delay in the settings. The hotspot default SSID is RpiHotspot and the default IP address of the Pi is (Make sure to enable either VNC or SSH server to remotely connect to your RPi at that address!)

Hotspot Tools:

Hotspot tools is a collection of tools designed to make managing the hotspot easier through a GUI interface.


This will install the needed utilities to get a GPS device configured as a time source on the RPi. Helpful when you are not connected to the Internet since the RPi doesn't have a real-time clock (RTC) and therefore will NOT keep accurate time when powered-off. Confirmed to work with this GPS: Other GPS units may work, but have not been tested.


Rig contol graphical interface.


Digital Mode Software


Forms manager for FLDIGI


Amateur Multicast Protocol - file transfer program


File encapsulation & compression


Winlink client for Raspberry Pi


Menu for configuring Pat. Recommended if installing Pat.


HF modem for Pat. Recommended if installing Pat.


GUI interface for ARDOPC. Recommended if installing Pat.


Software TNC. In this setup, Direwolf is used for a 2M packet connection with Pat, and can be used for APRS connection with Xastir. Recommended if installing Pat or Xastir.


AX.25 tools for Direwolf & Pat. Recommended if installing Pat.


Rig contol software.


Pulse audio. Provides a way to configure virtual sound cards. REQUIRED for AMRRON ops. (Get involved!


JS8Call digital software.


Tools for working with JS8Call. Recommended if installing JS8Call.


FT8 & WISPR software suite.


Software to program radios.


GUI interface useful when configuring APRS nodes.


Yet Another APRS Client GUI interface useful when configuring APRS nodes.


Logging software.


Satellite Tracking.


Logging Software.


Slow-scan TV (SSTV).


Propagation (VOACAP)

Propagation Prediction Software.

Emergency Email Server (EES):

My personal EES. Requires hotspot to be installed.
To access the EES, connect to the pi's hotspot, open a web browser, and navigate to
or open a web browser and navigate to the pi's ip adderss on your local network.
Admin credentials are admin/admin by default but can be changed in the file found at
For more configuration options -

Call Sign Lookup

Amateur radio call-sign lookup.

Dipole Calculator

Calculate lengths needed for dipole legs.

Log Viewer

Graphic viewer to view/manage log files.


Disk utility.