Skip to content

Pangolin setup guide

Create the initial directory

The pangolin script sets the initial folder to the folder you are currently in pwd. In order to avoid fucking up the directory ~/. the following structure is created: 

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

Install a container manager

Warning

Only the Docker configuration has been tested and is therefore currently the recommended one

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