🔥 Pyromanic 🔥

The Quick Authentication Reverse Proxy

Website — Documentation

Overview

Pyromanic is a quick and simple Reverse Proxy with Authentication

Running Pyromanic

1. Create a new Directory

mkdir pyromanic
cd pyromanic

2. Download the docker-compose.yaml from the GitHub Repo

wget https://raw.githubusercontent.com/TheHSI-HQ/Pyromanic/refs/heads/master/docker-compose.yaml

File Content

services:
  pyromanic:
    image: thehsi/pyromanic:latest # alt: ghcr.io/TheHSI-HQ/pyromanic
    restart: unless-stopped
    network: host # Recommended
    # ports:
    #  - "0.0.0.0:443:443"
    #  - "0.0.0.0:80:80" # Only use if you add a Proxy infront of Pyromanic
    volumes:
      - ./config:/app/config
      # - ./assets:/app/assets # Not needed but useful for logs, databases or metrics

3. Create a Config Directory:

mkdir config
cd config

4. Download the Config files from the GitHub Repo

wget https://raw.githubusercontent.com/TheHSI-HQ/Pyromanic/refs/heads/master/config/pyromanic.yaml
wget https://raw.githubusercontent.com/TheHSI-HQ/Pyromanic/refs/heads/master/config/secrets.yaml

5. Edit the Config Files

nano pyromanic.yaml
nano secrets.yaml

6. Create the Network and Start the Compose Stack

docker compose up -d

7. Start using Pyromanic by going to

https://<server-ip>