====== 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.

<code bash>
mkdir /home/peter/Heimdall
</code>

----

===== Determine the UID and GID =====

On the Ubuntu VM Host:

<code bash>
id peter
</code>

returns:

<code bash>
uid=1000(peter) gid=1000(peter) groups=1000(peter)...
</code>

<WRAP info>
**NOTE:**  Take a note of the UID and GID numbers.

  * In this case 1000.
</WRAP>

----

===== Install Heimdall =====

In Portainer:

  * Select **Stack**.
  * Click **Add Stack**.
  * Name:  **Heimdall**.
  * Web editor: <code>
---
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
</code>

<WRAP info>
**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 [[Systems:Docker Main:Install Docker Containers:Install Dozzle|Dozzle]].
</WRAP>

----

===== Confirm Heimdall is running =====

Open Portainer.

Press **F5** to refresh.

<WRAP info>
**NOTE:** This should show the Heimdall container running.
</WRAP>

----

===== Open Heimdall =====

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

<WRAP info>
**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.

</WRAP>

----

===== Setup Heimdall =====

Add whatever apps to Heimdall.

----

===== References =====

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

https://apps.heimdall.site/