# Proxmox Script for Pangolin Installation

**URL:** <https://forum.hhf.technology/t/proxmox-script-for-pangolin-installation/586>\
**Category:** Virtualization\
**Tags:** proxmox, pangolin\
**Created:** [February 11, 2025, 8:39pm UTC](https://forum.hhf.technology/t/proxmox-script-for-pangolin-installation/586 "2025-02-11T20:39:00Z")\
**Posts on this page:** 7\
**Page:** 1

<div class="post-metadata">

**Author:** ![hhf.technoloy](https://forum.hhf.technology/user_avatar/forum.hhf.technology/hhf.technoloy/32/68_2.png) [@hhf.technoloy](https://forum.hhf.technology/u/hhf.technoloy)\
**Post date:** [February 11, 2025, 8:39pm UTC](https://forum.hhf.technology/t/proxmox-script-for-pangolin-installation/586/1 "2025-02-11T20:39:00Z")

</div>

# Setting Up Pangolin on Proxmox: A Step-by-Step Guide

Pangolin is a powerful self-hosted reverse proxy management server with identity and access management capabilities. This guide will walk you through the process of installing Pangolin on a Proxmox VE container using our automated installation script.

## Prerequisites

Before you begin, make sure you have:

- A Proxmox VE server running (version 6.x or later)
- Administrative access to your Proxmox host
- A domain name that points to your Proxmox server’s IP address
- Ports 80 and 443 forwarded to your Proxmox server (from your router/firewall)
- Basic familiarity with Linux command line

## Creating a Container for Pangolin

First, you’ll need a container where Pangolin will run:

1. Log in to your Proxmox web interface
2. Create a new LXC container with these minimum specifications:
  - OS: Debian 11 or Ubuntu 20.04+
  - CPU: 1 core (2+ recommended)
  - RAM: 1GB minimum (2GB+ recommended)
  - Storage: 8GB minimum
  - Network: DHCP or static IP configuration

3. Start the container and note its CTID (Container ID) - you’ll need this later

## Downloading and Running the Installation Script

1. SSH into your Proxmox host server (not the container)
2. Download the installation script:

```bash
wget -O install-pangolin.sh https://gist.githubusercontent.com/hhftechnology/875fbf4fcfb1fcdeeb7fd1c086475b94/raw/a4363302d29356835e752f1eda172e32a29e45af/install-pangolin.sh

```

3. Make the script executable:

```bash
chmod +x install-pangolin.sh

```

4. Run the script as root:

```bash
sudo ./install-pangolin.sh

```

## Providing the Required Information

The script will prompt you for several pieces of information:

1. **Container ID (CTID)**: Enter the ID number of the container you created earlier.

2. **Domain Name** : Enter your fully qualified domain name (e.g., `proxy.example.com`). This domain must be pointed to your Proxmox server’s IP address.

3. **Admin Email** : Enter the email address you want to use for the Pangolin administrator account.

4. **Admin Password** : Create a strong password for the administrator account. The password must have:

5. **Let’s Encrypt Email** : Enter the email address for Let’s Encrypt certificate notifications. You can press Enter to use the same email as the admin account.

## Installation Process

Once you’ve provided all the required information, the script will:

1. Modify the container configuration to enable necessary features
2. Install Docker and Docker Compose in the container if they’re not already installed
3. Create the Pangolin configuration files with your customized settings
4. Start the Pangolin and Traefik containers
5. Verify the installation was successful

This process typically takes 2-5 minutes, depending on your server’s performance and internet connection speed.

## Post-Installation Steps

After the script completes successfully, you’ll see a message with post-installation instructions. Here’s what you need to do next:

1. **DNS Configuration** :

2. **Port Forwarding** :

3. **Initial Login** :

4. **Creating Your First Organization** :

5. **Setting Up Your First Site** :

6. **Creating Your First Resource** :

## Troubleshooting Common Issues

If you encounter any issues during or after installation:

- **Certificate Issues** : If Let’s Encrypt certificates aren’t being issued, make sure:

- **Connection Refused** : If you can’t connect to Pangolin after installation:

- **Login Issues** : If you can’t log in to the admin dashboard:

## Using Pangolin for Reverse Proxying

Now that Pangolin is installed, you can:

1. **Add More Resources** : Each resource corresponds to a service you want to access through the reverse proxy
2. **Configure Authentication** : Choose from various authentication methods for each resource
3. **Manage Access** : Create more users and assign them appropriate roles
4. **Monitor Traffic** : Use the dashboard to monitor the status of your resources

## Conclusion

Congratulations! You now have a fully functional Pangolin installation running on your Proxmox server. This setup allows you to securely access your self-hosted services through a centralized, authenticated reverse proxy.

The installation script has streamlined the setup process, configuring both Pangolin and Traefik with secure defaults. As you become more familiar with Pangolin, you can customize it further to meet your specific needs.

Remember to keep both your Proxmox host and Pangolin container updated with security patches, and periodically check for updates to Pangolin itself.

---

<div class="post-metadata">

**Author:** ![hexagram1959](https://forum.hhf.technology/letter_avatar_proxy/v4/letter/h/9d8465/32.png) [@hexagram1959](https://forum.hhf.technology/u/hexagram1959)\
**Post date:** [March 9, 2025, 2:19am UTC](https://forum.hhf.technology/t/proxmox-script-for-pangolin-installation/586/2 "2025-03-09T02:19:46Z")

</div>

Unfortunately, I have some issues with executing the script.

```auto
root@hv1:~/scripts# ./pangolin-proxmox-deploy.sh
./pangolin-proxmox-deploy.sh: line 668: syntax error near unexpected token `('
./pangolin-proxmox-deploy.sh: line 668: ` echo -e "${YELLOW}Installing UFW (Uncomplicated Firewall)...${NC}"'
root@hv1:~/scripts#

```

---

<div class="post-metadata">

**Author:** ![daschmidt](https://forum.hhf.technology/user_avatar/forum.hhf.technology/daschmidt/32/750_2.png) [@daschmidt](https://forum.hhf.technology/u/daschmidt)\
**Post date:** [March 9, 2025, 8:58am UTC](https://forum.hhf.technology/t/proxmox-script-for-pangolin-installation/586/3 "2025-03-09T08:58:42Z")

</div>

Maybe youbare able to add this to the community scripts from proxmox.  
[https://github.com/community-scripts/ProxmoxVE](https://github.com/community-scripts/ProxmoxVE)

---

<div class="post-metadata">

**Author:** ![hhf.technoloy](https://forum.hhf.technology/user_avatar/forum.hhf.technology/hhf.technoloy/32/68_2.png) [@hhf.technoloy](https://forum.hhf.technology/u/hhf.technoloy)\
**Post date:** [March 9, 2025, 9:21am UTC](https://forum.hhf.technology/t/proxmox-script-for-pangolin-installation/586/4 "2025-03-09T09:21:14Z")

</div>

I’m planning to look into it mid-week. I’m aiming to have a fix or an update by max by next Tuesday EOD, but I can’t guarantee it given my current workload. I’ll do my best to keep you updated on my progress."

---

<div class="post-metadata">

**Author:** ![hhf.technoloy](https://forum.hhf.technology/user_avatar/forum.hhf.technology/hhf.technoloy/32/68_2.png) [@hhf.technoloy](https://forum.hhf.technology/u/hhf.technoloy)\
**Post date:** [March 12, 2025, 4:31pm UTC](https://forum.hhf.technology/t/proxmox-script-for-pangolin-installation/586/5 "2025-03-12T16:31:42Z")

</div>

@daschmidt @hexagram1959 please retry and let me know.

---

<div class="post-metadata">

**Author:** ![dancgn](https://forum.hhf.technology/user_avatar/forum.hhf.technology/dancgn/32/700_2.png) [@dancgn](https://forum.hhf.technology/u/dancgn)\
**Post date:** [March 13, 2025, 5:59pm UTC](https://forum.hhf.technology/t/proxmox-script-for-pangolin-installation/586/6 "2025-03-13T17:59:53Z")

</div>

So I tried it, but there seems to be a Problem with the domain. All Containers are running, but the dashboard isn’t available because there seems to be no dashbord-url?  
My domain comes with cloudflare and work normally with a caddy reverse proxy.

---

<div class="post-metadata">

**Author:** ![hhf.technoloy](https://forum.hhf.technology/user_avatar/forum.hhf.technology/hhf.technoloy/32/68_2.png) [@hhf.technoloy](https://forum.hhf.technology/u/hhf.technoloy)\
**Post date:** [March 13, 2025, 6:14pm UTC](https://forum.hhf.technology/t/proxmox-script-for-pangolin-installation/586/7 "2025-03-13T18:14:04Z")

</div>

> [@dancgn](#):
>
> So I tried it, but there seems to be a Problem with the domain. All Containers are running, but the dashboard isn’t available because there seems to be no dashbord-url?

> [@hhf.technoloy](#):
>
> `https://gist.githubusercontent.com/hhftechnology/875fbf4fcfb1fcdeeb7fd1c086475b94/raw/a4363302d29356835e752f1eda172e32a29e45af/install-pangolin.sh`

 ![image](https://forum-cdn.hhf.technology/original/2X/1/14e5b7b131afe3f2ed8934c58f7a8e2f942054b5.png)  
Not sure. will get back to you on this

ohhh my bad

> [@dancgn](#):
>
> My domain comes with cloudflare and work normally with a caddy reverse proxy.

it’s not setup for cloudflare.

[Wildcard Certificates with Let’s Encrypt | Fossorial Docs](https://docs.fossorial.io/Pangolin/Configuration/wildcard-certs#wildcard-config-for-dns-01-challenge)  
scroll at the bottom.
