Introduction
Gotify is a free and open source project that lets you control your data and communicate via a REST-API and a web socket. You can download, self host, or use Docker to run Gotify on different platforms and devices.
The Docker Compose File
---
version: "3.8"
services:
gotify:
image: gotify/server:latest
container_name: gotify
hostname: gotify
restart: unless-stopped
network_mode: host
security_opt:
- no-new-privileges:true
environment:
- TZ=Europe/Stockholm
ports:
- 80:80
volumes:
- /opt/gotify/config:/app/data
- /etc/localtime:/etc/localtime:ro
labels:
- com.centurylinklabs.watchtower.enable=truedocker-compose.yml
This Docker Compose file defines a single service named “gotify”. The service is built from the “gotify/server:latest” Docker image, which is the latest version available. The container name is set to “gotify” as well.
The “restart” section ensures that the container will always be restarted if it exits (unless manually stopped). This is useful for ensuring that the service is always available, especially if it crashes or is shut down unexpectedly.
The “security_opt” section prevents your container processes from gaining additional privileges. This is an important security consideration.
The “ports” section maps port 80 on the host machine to port 80 in the container. This allows us to access the gotify web interface from our local machine. By default, gotify runs on port 80, but you can change it if necessary.
The “volumes” section maps the “/data” directory inside the container to a local directory on the host machine. This allows us to persist data across container restarts. gotify stores all its configuration and monitoring data in this directory, so it’s important to keep it intact.
The "labels" section allows the Watchtower service to keep this container update automatically
Running Gotify with Docker Compose
To run Gotify with Docker Compose, first, make sure you have Docker and Docker Compose installed on your machine. Then, create a new directory for your project and save the above Docker Compose file as “docker-compose.yml” in that directory.
Next, run the following command from the same directory:
docker compose up -dThis command will start the Gotify container in the background and detach from it. You can then access the Gotify web interface by going to http://localhost in your web browser.
Conclusion
In this article, we explored how to set up and run the Gotify software using Docker Compose. We looked at the different sections of the Docker Compose file and explained how they work together to create a functional Gotify service. By running Gotify with Docker Compose, you can easily deploy and manage the tool on your own server, without having to worry about dependencies or configuration.
