Skip to content

Updating

Jump to bottom
W9KSB edited this page Jun 10, 2026 · 1 revision

Updating

Recommended Update Method

Use the updater created on the Pi during installation:

cd ~/pi-sat
sh update_pi.sh

What the Updater Does

The local updater:

  1. stops the pi-sat service
  2. fetches the latest Git changes
  3. fast-forwards the local checkout
  4. refreshes Python dependencies
  5. restarts the service

Why the Updater Is Local

The updater is generated locally so each Pi can preserve its own runtime files and configuration behavior without depending on those files being overwritten from Git.

Preserved Local Files

Local files such as:

  • pi-sat-controller.conf
  • update_pi.sh

should remain local to the Pi and should not be treated as normal repository content.

Manual Update Flow

If you want to update manually:

cd ~/pi-sat
sudo systemctl stop pi-sat
git fetch --all --prune
git pull --ff-only
. .venv/bin/activate
python -m pip install -r requirements.txt
sudo systemctl start pi-sat

After Updating

Validate:

  • the service starts cleanly
  • the dashboard loads
  • passes are present
  • devices still connect
  • TLE refresh still works

As with any software, I always recommend you do a quick live validation before relying on the updated system for an actual pass.

Clone this wiki locally