Skip to main content

Pangolin Install Guide

Pangolin is 

Most of the guide is from their doc page, however, there is a part missing for making proxy redirect work properly. 

Pangolin Quick Install Guide

VPS Hardening Security Guide

 
Pangolin Install Guide

This will resolve an issue of https://pangolin.cyberpaw.org/auth/initial-setup site not being reachable, or getting Invalid ssl cert error.

  1. Login trough SSH to VPS server that is preset with necessary security steps
  2. Download the installer
curl -fsSL https://digpangolin.com/get-installer.sh | bash
  1. Run the installer
sudo ./installer
  1. Once installer is finished Configure basic Settings from prompts. The installer will prompt you for essential configuration:
    1. Base Domain: Enter your root domain without subdomains (e.g., example.com)
    2. Dashboard Domain: Press Enter to accept the default pangolin.example.com or enter a custom domain
    3. Let’s Encrypt Email: Provide an email for SSL certificates and admin login
    4. Tunneling: Choose whether to install Gerbil for tunneled connections (default: yes). You can run Pangolin without tunneling. It will function as a standard reverse proxy.
    5. Email Configuration: Say no, if you don't have SMTP server set up
    6. CrowdSec: say Yes to install and self manager CrowdSec
  2. Once installer is ready try to go to:
https://pangolin.example.com/auth/initial-setup

If you get Invalid SSL Certificate error or Site can't be reached continue with steps below

Traefik dynamic_config.yml Change
  1. Navigate to Traefik Config Directory
cd /config/traefik
  1. Backup existing file
cp dynamic_config.yml dynamic_config.yml.bak
  1. Edit yml
nano dynamic_config.yml
  1. Add new line in router part
    setup-router:
      rule: "Host(`pangolin.cyberpaw.org`) && PathPrefix(`/auth`)"
      service: api-service
      entryPoints:
        - websecure
      tls:
        certResolver: letsencrypt
  1. Save and Exit
  2. Restart traefik container
docker restart <traefik_container_name>


Now try to go to initial setup and follow initial steps.