# Running Heimdall Application Dashboard Using Docker

## Installing Docker

1. Log into the Linux Docker host and run the following commands in a terminal window
   # install prerequisites
   sudo apt install apt-transport-https ca-certificates curl software-properties-common gnupg-agent -y
   # add docker gpg key
   curl -fsSL https://download.docker.com/linux/$(awk -F'=' '/^ID=/{ print $NF }' /etc/os-release)/gpg | sudo apt-key add -
   # add docker software repository
   sudo add-apt-repository "deb [arch=$(dpkg --print-architecture)] https://download.docker.com/linux/$(awk -F'=' '/^ID=/{ print $NF }' /etc/os-release) $(lsb_release -cs) stable"
   # install docker
   sudo apt install docker-ce docker-compose containerd.io -y
   # enable and start docker service
   sudo systemctl enable docker && sudo systemctl start docker
   # add the current user to the docker group
   sudo usermod -aG docker $USER
   # reauthenticate for the new group membership to take effect
   su - $USER

## Running Heimdall Application Dashboard

1. Continue with the following commands in a terminal window
   # list current uid and gid, note these for later
   id $user
   # make a heimdall directory to mount in the container
   mkdir ~/heimdall
   # run the heimdall docker image
   # replace PUID, GUID with the output of the id $user command above
   docker run --name=heimdall -e PUID=1001 -e PGID=1001 -e TZ=america/new_york -p 8006:80 -v ~/heimdall:/config --restart unless-stopped linuxserver/heimdall
2. Open a web browser and navigate to http://localhost:8006
3. Open a file manager and navigate to ~/heimdall to see the files the container has created

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