<h3>How to Install and Run Pangolin Locally on Your Server</h3>
Pangolin is a self-hosted reverse proxy management server designed to simplify identity and access control with an intuitive user interface. It integrates seamlessly with Traefik and WireGuard tunnel clients and can be hosted on both local servers and cloud services such as Linode and Vultr. This guide will cover the prerequisites for setup, step-by-step installation, and configuration, as well as a look into Pangolin’s features and future enhancements.
<h4>Prerequisites</h4>
Before starting, ensure you have:
<ul>
<li>A home server or a cloud service (e.g., Linode, Vultr)</li>
<li>Basic knowledge of command line and SSH</li>
<li>A registered domain with access to the DNS settings for creating A records</li>
</ul>
<h4>Step-by-Step Installation</h4>
<ol>
<li>
Access Your Server via SSH:
Open a terminal and connect to your server using SSH.
<pre><code class="language-sh">ssh your_user@your_server_ip
</code></pre>
</li>
<li>
Update Your Server:
Ensure your server is up to date with the latest packages.
<pre><code class="language-sh">sudo apt update &amp;&amp; sudo apt upgrade -y
</code></pre>
</li>
<li>
Install Necessary Software:
Install Docker and Docker Compose to run Pangolin.
<pre><code class="language-sh">sudo apt install docker.io docker-compose -y
sudo systemctl start docker
sudo systemctl enable docker
</code></pre>
</li>
<li>
Clone the Pangolin Repository:
Navigate to your desired directory and clone the Pangolin repository.
<pre><code class="language-sh">git clone https://github.com/pangolin/pangolin.git
cd pangolin
</code></pre>
</li>
<li>
Create A Records for Your Domain:
Point your domain to your server’s IP address by creating A records in your domain’s DNS settings.
</li>
<li>
Configure Pangolin:
Update the configuration files to suit your environment.
<pre><code class="language-sh">cp .env.example .env
nano .env
</code></pre>
Fill in the required details including your domain name.
</li>
<li>
Run Pangolin:
Use Docker Compose to start Pangolin.
<pre><code class="language-sh">docker-compose up -d
</code></pre>
</li>
</ol>
<h4>Using the Pangolin Dashboard</h4>
<ul>
<li>Login and Setup: Access the Pangolin dashboard via your domain. The default credentials can be found in the documentation. Change them immediately for security.</li>
<li>Create Organizations and Sites: Structure your setup by creating organizations and sites within the dashboard.</li>
<li>Add Resources and Subdomains: Add private resources that you need to expose and set up subdomains as necessary.</li>
<li>Authentication Methods: Pangolin supports multiple authentication methods, including 2FA. Enable and configure these to enhance security.</li>
</ul>
<h4>Future Features and Final Thoughts</h4>
Pangolin is an evolving project with planned future enhancements to further simplify reverse proxy management and improve security features. It offers a clean and effective interface for managing access to private resources, making it a valuable tool for both personal and professional use. Whether hosting locally or on the cloud, Pangolin ensures your resources are securely exposed through encrypted tunnels with robust authentication methods.
The installation and configuration are straightforward and well-documented, offering a user-friendly experience that can be adapted to various environments.

Collections

Pangolin is a self-hosted reverse proxy management server that simplifies identity and access control. It integrates with Traefik and WireGuard, and can be hosted both locally and on cloud services like Linode and Vultr. The guide walks through prerequisites, installation, and configuration, and covers using the dashboard to manage organizations, sites, resources, and authentication methods. Pangolin offers future enhancements for improved security and ease of use.