Docker-Compose method - Recommended
Install Docker
Update the repo to get latest versions
sudo apt update
Install the latest version
sudo apt install docker.io
Set Docker to start on startup
sudo systemctl enable --now docker
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 v2.16.0, just change this if the version updates to a later version
sudo curl -L "https://github.com/docker/compose/releases/download/v2.16.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
Give permissions to this
sudo chmod +x /usr/local/bin/docker-compose
Test it has installed correctly by getting the docker-compose version
docker-compose --version
Install Uptime Kuma
I keep all my dockers in a dockers folder in my home directory. If it doesn’t exist already, create this folder:-
mkdir ~/dockers
Now create a folder for Uptime Kuma to live in.
mkdir ~/dockers/uptimekuma
Create a folder for the data
mkdir ~/dockers/uptimekuma/data
Change directory to this folder
cd ~/dockers/uptimekuma
Create a docker-compose.yml file
nano docker-compose.yml
Paste the following. Change the first 3001
part of 3001:3001
if you want it to listen on an alternative port to port 3001.
version: '3.3'
services:
uptime-kuma:
image: louislam/uptime-kuma
container_name: uptime-kuma
volumes:
- ./data:/app/data
ports:
- 3001:3001
Save the file with ctl + x, then y to save.
Run the docker-compose file with the following:-
docker-compose up -d
Browse to the server ip and the port mentioned in the compose file, eg http://1.1.1.1:3001 and you should get the default dashboard.