Docs · 2 min read

Installing PiSky

The unified installer, from a fresh Raspberry Pi OS Bookworm image to a running station.

PiSky's first installation target is a clean Raspberry Pi OS Bookworm 64-bit system on a Raspberry Pi 4 or 5. Use a disposable or backed-up SD card — this release is intended for hardware validation before production use.

In Raspberry Pi Imager, choose Raspberry Pi OS (Legacy, 64-bit) Bookworm with the desktop environment, and configure hostname, user, Wi-Fi, locale and SSH if needed.

Run the installer

sudo apt update
sudo apt install -y git
git clone https://github.com/davidmgilbert/pisky.git
cd pisky
./install-pisky.sh

Run it as the normal Pi user, not with sudo — it requests elevated permission only for package installation and tightly scoped system changes.

The default --full profile enables every capability. Because Camera, Weather and Aircraft are independent, useful narrower profiles include:

# Camera only
./install-pisky.sh --minimal

# Weather-only appliance using free Open-Meteo
./install-pisky.sh --without-camera --with-weather --without-weewx --without-adsb

# Local aircraft receiver plus weather, no camera or WeeWX
./install-pisky.sh --without-camera --with-weather --without-weewx --with-adsb

# Camera and local ADS-B, without public weather
./install-pisky.sh --without-weather --with-adsb

# Inspect the selected installation without changing the Pi
./install-pisky.sh --dry-run

When the inherited Allsky stage asks whether to reboot immediately, choose No — this lets the unified installer finish PiSky core, WeeWX and ADS-B before one final reboot.

First login

Open http://PI_ADDRESS/admin/?page=pisky_setup. On a completely fresh configuration, the inherited initial credentials are username admin and password secret — change them immediately from Change Password.