Adjusted guide from discussion #778 #841

^{Originally posted by KodeStar March 17, 2022}

Install Docker

Step 1 – Add the GPG key for the official Docker repository to the system:

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

Step 2 – Add the Docker repository to APT sources:

sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"

Step 3 – Update the package database with the Docker packages from the newly added repository:

sudo apt-get update

Step 4 – Make sure you are about to install from the Docker repo instead of the default Ubuntu 16.04 repo:

apt-cache policy docker-ce

You should see something similar to the following:

docker-ce:
  Installed: (none)
  Candidate: 17.03.1~ce-0~ubuntu-xenial
  Version table:
     17.03.1~ce-0~ubuntu-xenial 500
        500 https://download.docker.com/linux/ubuntu xenial/stable amd64 Packages
     17.03.0~ce-0~ubuntu-xenial 500
        500 https://download.docker.com/linux/ubuntu xenial/stable amd64 Packages

Notice that docker-ce is not installed, but the candidate for installation is from the Docker repository for Ubuntu 16.04. The docker-ce version number might be different.

Step 5 – Finally, install Docker:

sudo apt-get install -y docker-ce

Docker should now be installed, the daemon started, and the process enabled to start on boot. Check that it’s running:

sudo systemctl status docker

The output should be similar to the following, showing that the service is active and running:

● docker.service - Docker Application Container Engine
   Loaded: loaded (/lib/systemd/system/docker.service; enabled; vendor preset: enabled)
   Active: active (running) since Sun 2016-05-01 06:53:52 CDT; 1 weeks 3 days ago
     Docs: https://docs.docker.com
 Main PID: 749 (docker)

Install Heimdall

Step 1 – Check your user and group

id

You should see something similar to

kodestar@sd-100821:$ id
uid=1000(kodestar) gid=1000(kodestar) groups=1000(kodestar),4(adm),24(cdrom),27(sudo),30(dip),46(plugdev),116(lpadmin),117(sambashare)

Step 2 – Create a folder to store your docker data, if the directory doesn’t exist it will be created by the docker command anyway, but you might as well create the folder so you get clear in your mind where you are going to put things, plus you want to create the first level directory as your user otherwise it will be owned by root

mkdir /home/kodestar/docker

Step 3 – Create the docker

sudo docker run --name=heimdall -d -v /home/kodestar/docker/heimdall:/config -e PGID=1000 -e PUID=1000 -p 8080:80 -p 8443:443 linuxserver/heimdall

Step 4 – Once the docker has finished building just hit it in your browser at http://127.0.0.1:8080