Homer is a web-based dashboard tool that provides a customizable interface for accessing frequently used web applications, services, and tools. Homer is an open-source project available under the Apache License 2.0.
This tutorial explains how to install Homer inside a Docker container in the Linux. Commands have been tested on Ubuntu.
Make sure you have installed Docker in your system. If you are using Ubuntu, installation instructions can be found in the post.
Before starting, create a directory for assets:
sudo mkdir -p /opt/homer/assets
Set user, which ID is 1000 as owner for newly created directory:
sudo chown -R 1000:1000 /opt/homer
Note: it doesn't matter that user (ID: 1000) doesn't exist on host system. This user will be created in the container.
- Host network
Run the following command to create a container for Homer that uses host network:
docker run -d --name=homer --restart=always --network=host \ -v /opt/homer/assets:/www/assets \ b4bz/homer
- User-defined bridge network
User-defined bridge network can be used for listening on different port. By default, Homer service is listening on port 8080. It can be changed with
docker network create app-net
docker run -d --name=homer --restart=always --network=app-net \ -p 8081:8080 \ -v /opt/homer/assets:/www/assets \ b4bz/homer
To access dashboard, open a web browser and go to
<IP_ADDRESS> is the IP address of the system.
Title, icons, links, colors, and services can be configured in the
sudo nano /opt/homer/assets/config.yml
Once the file was updated, refresh the browser to see changes.
To completely remove Homer, remove its container:
docker rm --force homer
Remove Homer image:
docker rmi b4bz/homer
You can also remove Homer assets:
sudo rm -rf /opt/homer
If a user-defined bridge network was created, you can delete it as follows:
docker network rm app-net
Leave a CommentCancel reply