Skip to main content

Heimdall

Heimdall is a self-hosted homepage, I like to use it to give a central page to access all web-GUIs for VMs and containers running on Proxmox.

Step 1 - Spin up ubuntu VM clone

image.png

Step 2 - Start new VM and run boilerplate script

sudo bash -c "bash <(wget -qO- https://raw.githubusercontent.com/dlford/ubuntu-vm-boilerplate/master/run.sh)"

Step 3 - Assign IP Address in PfSense Firewall, and Aliases, open ports

Services -> DHCP Server -> Add

Firewall -> Aliases -> Add

Firewall -> NAT -> Add -> Destination self, port 8085 -> heimdall, port 8085

Step 4 - Install docker and docker-compose

sudo apt update
sudo apt install docker docker-compose -y 

Step 5 - Docker-compose.yml

version: "2.1"
services:
  heimdall:
    image: lscr.io/linuxserver/heimdall:latest
    container_name: heimdall
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Europe/London
    volumes:
      - </path/to/appdata/config>:/config
    ports:
      - "8085:80"
      - "8086:443"
    restart: unless-stopped
sudo docker-compose up -d

Step 6 - Open Heimdall webpage

http://<PfSense Router WAN IP>:8085