Skip to content

Pangolin setup guide

Creare la cartella iniziale

Lo script di pangolin imposta come crtella iniziale la cartella nella quale si è attualmente pwd. Al fine di evitare lo sputtanamento della directory ~/. si crea la segente struttura:

mkdir ~/appdata && mkdir ~/appdata/pangolin
cd ~/appdata/pangolin

Installare un gestore per container

Warning

Sono la configurazione su docker è stata testata e dunque attualmente è quella consigliata

Install Podman (Official Docs)

sudo apt install podman

Install Docker (Official Docs)

Install

sudo apt update
sudo apt install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

Add Docker repo:

sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/debian
Suites: $(. /etc/os-release && echo "$VERSION_CODENAME")
Components: stable
Signed-By: /etc/apt/keyrings/docker.asc
EOF

Install Docker:

sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
sudo docker run hello-world
sudo systemctl enable docker
sudo systemctl status docker

Install Pangolin

mkdir ~/dockerfiles && mkdir ~/dockerfiles/pangolin
cd dockerfiles/pangolin
curl -fsSL https://pangolin.net/get-installer.sh | bash
sudo ./installer

Unraid Note

  • Install Newt from the UnRaid appstore and configure
  • Add to docker run string: --network proxynet

Operational isntructions

Note

  • Remember TCP forward for Pangolin & Traefik updates.
  • Update Cloudflare API IP rules (Wildcard domains)
  • Do not set the status monitor for services that returns 501 (it'll return 404 on the web page)

When you want to refresh traefik various configs or in general reboot Pangolin do in the docker-compose.yml directory:

sudo docker down
sudo docker compose up -d
sudo podman down
sudo podman compose up -d