1. Pangolin Pre-Update Requirements#

Backup Data#

Always backup your data before updating. Copy your config directory to a safe location to allow for a rollback if necessary.

Version Strategy#

Update incrementally between major versions (e.g., 1.0.0 → 1.1.0 → 1.2.0) rather than skipping major releases.

2. Update Process#

Stop the Stack#

Stop all running containers:

sudo docker compose down

Check Latest Versions#

Before editing your configuration, verify the current stable release versions for each component:

• Pangolin: GitHub Releases
• Gerbil: GitHub Releases
• Traefik: Docker Hub
• Badger: GitHub Releases

Update Configuration#

Edit your docker-compose.yml and config/traefik/traefik_config.yml files with the latest version numbers.

docker-compose.yml

services:
  pangolin:
    image: fosrl/pangolin:1.7.3 # Update to latest
  gerbil:
    image: fosrl/gerbil:1.2.1   # Update to latest
  traefik:
    image: traefik:v3.4.0       # Update if needed

traefik_config.yml

experimental:
  plugins:
    badger:
      moduleName: [github.com/fosrl/badger](https://github.com/fosrl/badger)
      version: v1.3.0 # Update to latest

Apply Updates#

Pull the new images and start the stack:

sudo docker compose pull
sudo docker compose up -d

Monitor and Verify#

Check the logs to ensure the migration scripts and services start correctly:

sudo docker compose logs -f