Quick Install Guide
Deploy your own remote Pangolin node in under 10 minutes with our automated installer
Prerequisites
Before you begin, ensure you have:
- Pangolin Cloud account. You can create a free account here OR a clustered self-hosted Pangolin Enterprise deployment.
- Linux server with root access and public IP address.
- Open ports on firewall for 80 (TCP), 443 (TCP), 51820 (UDP), and 21820 (UDP for clients).
Recommended: Ubuntu 20.04+ or Debian 11+ for best compatibility and performance.
Choose Your Server
Need help choosing? See our complete VPS guide for suggestions.
Networking
Before installing Pangolin, ensure you've opened the required port on your firewall. See our guide on networking for more information.
Installation Process
Download the installer
Connect to your server via SSH and download the installer:
curl -fsSL https://static.pangolin.net/get-node-installer.sh | bashThe installer supports both AMD64 (x86_64) and ARM64 architectures.
Run the installer
Execute the installer with root privileges:
sudo ./installerThe installer places all files in the current directory. Move the installer to your desired installation directory before running it.
If you're not using Pangolin Cloud (app.pangolin.net) and instead have a self-hosted Pangolin Enterprise deployment, pass its URL with the --pangolin-endpoint flag so the installer requests node credentials from your instance instead:
sudo ./installer --pangolin-endpoint https://pangolin.example.comDo you already have credentials from the dashboard?
If you are on your game and have already generated credentials for this node in the dashboard enter them here.
If you don't have them yet you can just select no when asked and we will create it in a later step.
The public addressable IP address for this node
Enter either the public IP address of your server or a domain name that resolves to it.
The installer will attempt resolve and prefill your public IP address. Verify this is correct before preceding.
If you choose to use a domain keep in mind this just resolves your node on the internet while the actual subdomains for resources will be managed in the server.
Generate credentials
If you did not enter credentials earlier then you should see something like the following:
Your managed credentials have been obtained successfully.
ID: he4g78wevj25msf
Secret: n7sd18twfko0q0vrb7wyclqzbvvnx1fqt7ezv8xewhdb9s7dGo to the Pangolin dashboard (or your own panel's URL if you passed --pangolin-endpoint) and log in. Navigate to the "Self-hosted" section and add a new node. Select the adopt method. Use this ID and secret to register your node.
More than one account can use the same node credentials. This is useful for teams.
Post-Installation Setup
Once installation completes successfully, you'll see:
Installation complete!Navigate to the Pangolin dashboard (or your own dashboard if self-hosted) and create sites, resources, and targets for your remote node.
Was this page helpful?