Skip to main content

Try free on Pangolin Cloud

Fastest way to get started with Pangolin using the hosted control plane. No credit card required.
Updating Pangolin is straightforward since it’s a collection of Docker images. Simply pull the latest images and restart the stack. Migration scripts run automatically to update your database and configuration files when needed.

​
Before You Update

Always backup your data before updating. Copy your config directory to a safe location so you can roll back if needed.
Recommended: Update incrementally between major versions. For example, update from 1.0.0 → 1.1.0 → 1.2.0 instead of jumping directly from 1.0.0 → 1.2.0.

​
Update Process

1

Stop the stack

Stop all running containers:
sudo docker compose down
2

Check latest versions

Find the latest version numbers:
Look for the latest stable release (not pre-release or beta versions).
3

Update version numbers

Edit your docker-compose.yml file and update the image versions:
docker-compose.yml
services:
  pangolin:
      image: fosrl/pangolin:1.7.3  # Update to latest version
      # ... rest of config

  gerbil:
      image: fosrl/gerbil:1.2.1   # Update to latest version
      # ... rest of config
  
    traefik:
      image: traefik:v3.4.0       # Update if needed
      # ... rest of config
Increase the Badger version number in config/traefik/traefik_config.yml:
traefik_config.yml
experimental:
  plugins:
    badger:
      moduleName: github.com/fosrl/badger
      version: v1.3.0 # Update to latest version
Update each service you want to upgrade. You can update them individually or all at once.
4

Pull new images

Download the updated Docker images:
sudo docker compose pull
5

Start the stack

Start the updated containers:
sudo docker compose up -d
6

Monitor the update

Watch the logs to ensure everything starts correctly:
sudo docker compose logs -f
7

Verify functionality

Test that everything is working:
  1. Access your Pangolin dashboard
  2. Check that all sites are accessible
  3. Verify tunnel connections (if using Gerbil)
  4. Test any custom configurations
If everything works, your update is complete!