Systems - Docker Main - Install Docker Containers - Install Heimdall

Heimdall provides a nice browser home page, from which it is easy to access other apps or sites.

Create the Heimdall Config Directory

Heimdall will store its configuration data in a directory on the Host VM.

On the Ubuntu VM Host, create a directory for this config data.

mkdir /home/peter/Heimdall

Determine the UID and GID

On the Ubuntu VM Host:

id peter

returns:

uid=1000(peter) gid=1000(peter) groups=1000(peter)...

NOTE: Take a note of the UID and GID numbers.

In this case 1000.

Install Heimdall

In Portainer:

Select Stack.
Click Add Stack.
Name: Heimdall.

Web editor:

---
version: "2.1"
services:
  heimdall:
    image: ghcr.io/linuxserver/heimdall
    container_name: heimdall
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Europe/Jersey
    volumes:
      - /home/peter/Heimdall:/config
    ports:
      - 8889:80
      - 8443:443
    restart: unless-stopped

NOTE: Change settings as required.

/home/peter/Heimdall: This directory will need to be created on the host.
PUID and GUID: Set to the numbers determined earlier.
Port 8889: Change as required.
- The default is 8888, but this is already being used by Dozzle.

Confirm Heimdall is running

Open Portainer.

Press F5 to refresh.

NOTE: This should show the Heimdall container running.

Open Heimdall

Visit http://192.168.1.30:8889 in a browser.

NOTE: The IP address is whatever the Ubuntu VM is using.

The 8889 port is the port configured for Heimdall.

It is suggested to set this URL in the web browser to be the default loading page.

Setup Heimdall

Add whatever apps to Heimdall.

References

https://hub.docker.com/r/linuxserver/heimdall

https://apps.heimdall.site/

Wiki

Table of Contents