1. Pangolin Pre-Update Requirements#

1.1. Backup Data#

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

1.2. 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#

2.1. Stop the Stack#

Stop all running containers:

sudo docker compose down

2.2. 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](https://hub.docker.com/_/traefik)
• Badger: GitHub Releases

2.3. 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

2.4. Apply Updates#

Pull the new images and start the stack:

sudo docker compose pull
sudo docker compose up -d

2.5. Monitor and Verify#

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

sudo docker compose logs -f