Skip to content

Pangolin VPS Recovery Runbook

Prerequisites

  • Fresh Debian 13 VPS spun up at RackNerd (or equivalent)
  • SSH access to the new VPS
  • Access to Synology NAS backup share

Step 1 - Initial System Setup

apt update && apt upgrade -y
apt install -y docker.io docker-compose ufw rsync curl

Step 2 - Restore UFW Rules

rsync -avz jeff@100.113.48.77:/volume1/Backups/pangolin-vps/LATEST/ufw/ /etc/ufw/
ufw enable
ufw status

Step 3 - Create User and Restore App

useradd -m -s /bin/bash jeff
rsync -avz jeff@100.113.48.77:/volume1/Backups/pangolin-vps/LATEST/pangolin/ /home/jeff/
chown -R jeff:jeff /home/jeff

Step 4 - Start Pangolin

cd /home/jeff
docker compose pull
docker compose up -d
docker compose ps

Step 5 - Verify

  • Check docker compose ps shows all three containers healthy
  • Verify Traefik/Pangolin dashboard is accessible
  • Test a proxied service end-to-end

Notes

  • Let's Encrypt certs are included in the backup under config/letsencrypt
  • Gerbil WireGuard key is included in config/ - existing tunnels should reconnect automatically
  • If certs are expired (unlikely within 30 day retention), run: docker compose restart traefik