Give your user permissions to docker, replacing user with your username
sudo usermod -aG docker user
Once you have run this command close and reopen your session if you accessing remotely. This is to apply the permissions in the above step
Test it has installed correctly by getting the docker version
docker --version
Docker Compose
I also install docker-compose as some dockers need you to compose from a yml file. This downloads 1.29.2, just change this if the version updates to a later version
Paste the following in for a basic site setup (change the server_name for your server name/ip. Change listen to a port you want this to listen on. I’m using :89 as my custom port. The default from homer docker is 8080, so you would use listen 8080 in the below along with listen [::]:8080)
server {
listen 89;
listen [::]:89;
server_name homer.example.com;
# Path to the root of your installation
root /usr/share/nginx/homer/;
access_log /var/log/nginx/homer.access;
error_log /var/log/nginx/homer.error;
}
Test the nginx config.
sudo nginx -t
If the above comes back successfully, restart nginx service.
sudo systemctl reload nginx
Browse to the site mentinoed in the config file, eg http://homer.example.com:89 and you should get the default dashboard.
Now it’s all installed, to configure, edit the following file.
Install Docker
Update the repo to get latest versions
Install the latest version
Set Docker to start on startup
Give your user permissions to docker, replacing
user
with your usernameOnce you have run this command close and reopen your session if you accessing remotely. This is to apply the permissions in the above step
Test it has installed correctly by getting the docker version
Docker Compose
I also install docker-compose as some dockers need you to compose from a yml file. This downloads 1.29.2, just change this if the version updates to a later version
Give permissions to this
Test it has installed correctly by getting the docker-compose version
Install Homer
I keep all my dockers in a dockers folder in my home directory. If it doesn’t exist already, create this folder:-
Now create a folder for Homer to live in.
Create a folder for the assets
Change directory to this folder
Create a docker-compose.yml file
Paste the following. Change the
89
part of89:8080
if you want it to listen on an alternative port to port 89.Save the file with ctl + x, then y to save.
Run the docker-compose file with the following:-
Now it’s all installed, to configure, edit the following file.
sudo nano /home/dockers/homer/assets/config.yml
Installing nginx if it’s not installed
First, update the repo to get latest versions
Install nginx
Enable the service to start on boot
Installing Homer Dashboard
First download the latest release from the github repo. From your home directory run the following.
Next, extract homer into the nginx folder
If the above command fails because you haven’t got unzip intalled, use the following to install, then re-run the above command.
Amend the permissions on the homer folder
Get the default config from homer dist
Create nginx config file
Paste the following in for a basic site setup (change the
server_name
for your server name/ip. Changelisten
to a port you want this to listen on. I’m using :89 as my custom port. The default from homer docker is 8080, so you would uselisten 8080
in the below along withlisten [::]:8080
)Test the nginx config.
If the above comes back successfully, restart nginx service.
Now it’s all installed, to configure, edit the following file.
sudo nano /usr/share/nginx/homer/assets/config.yml
https://www.llewellynhughes.co.uk/post/installing-homer-manual/