How to Set Up Gotify for Real-Time Notifications and Integrate It with Uptime Kuma

A proper Gotify Setup ensures you have a self-hosted notification server delivering real-time alerts straight to your devices. If you’re looking for a secure, customizable solution that puts you in full control of your notifications, a Gotify Setup might be exactly what you need. In this guide, you’ll learn what Gotify is, how to perform a Gotify Setup, and why integrating it with Uptime Kuma can keep you instantly informed about critical uptime events.

What Is Gotify?

Gotify is an open-source, self-hosted notification server that lets you send push messages to all your devices without relying on external services. Implementing a Gotify Setup gives you privacy, customization, and reliable real-time alerts—perfect for server monitoring, custom app notifications, and integrating with uptime monitoring tools like Uptime Kuma.

Reasons for Gotify

1. Full Data Control: Host and manage your own notification infrastructure.
2. Real-Time Notifications: Receive alerts instantly across all connected devices.
3. Open-Source & Flexible: Easily adapt, customize, and enhance your Gotify Setup to suit your needs.
4. Seamless Integration: Pairing your Gotify with Uptime Kuma ensures you never miss critical downtime alerts.

What You Need for Your Gotify

• A server or VPS (Linux-based recommended) with Docker installed.
• Optional: A domain name for a clean URL and enabling HTTPS.
• Basic knowledge of Docker and Linux commands to manage your Gotify Setup efficiently.

How to Install and Configure Your Gotify Setup with Docker

1. Install Docker & Docker Compose:
   Debian/Ubuntu:

sudo apt update &&  sudo apt install docker.io docker-compose -ysudo systemctl enable docker && sudo systemctl start docker

1. Create a Docker-Compose File for Your Gotify:
   In a dedicated directory, create a docker-compose.yml file:

version: "3"

services:
  gotify:
    image: gotify/server:latest
    container_name: gotify
    restart: always
    ports:
      - "80:80"
    volumes:
      - ./data:/app/data

1. Start Gotify:
   This pulls the Gotify image, starts the server, and creates the necessary directories.

docker-compose up -d 

1. Accessing the Gotify Interface:
   Open your browser and go to:
   • http://<your_server_ip> or http://<your_domain>
   After logging in (use the admin credentials displayed in the container logs with docker logs gotify), you can create a new application. Copy the application token—this will be used to integrate your Gotify Setup with other tools like Uptime Kuma.
2. Optional: Secure Your Gotify with HTTPS:
   For production environments, protect your Gotify using a reverse proxy (e.g., Nginx, Caddy) and Let’s Encrypt SSL certificates. Refer to the Gotify documentation for detailed instructions.

Why Use Your Gotify with Uptime Kuma

Uptime Kuma is an excellent self-hosted monitoring tool that keeps track of your servers and websites. By integrating your Gotify Setup with Uptime Kuma, you’ll receive immediate notifications whenever downtime or performance issues occur, ensuring you always stay ahead of problems.

Benefits of Gotify with Uptime Kuma:

• Instant Alerts: Get notified the moment your site or server experiences downtime.
• Centralized Messaging: Keep all critical alerts in one place with your Gotify Setup.
• Full Customization: Both tools are self-hosted and open-source, giving you control and flexibility.

Integrating Uptime Kuma into Your Gotify

1. Obtain Your Gotify Application Token:
   • Log into your Gotify web interface.
   • Navigate to your application and copy the application token. This token ties Uptime Kuma alerts directly to your Gotify Setup.
2. Add a Gotify Notification in Uptime Kuma:
   • Log into your Uptime Kuma dashboard.
   • Go to “Settings” > “Notifications” and click “Add New Notification”.
   • Select “Gotify” as the notification type.
3. Configure Your Gotify Notification in Uptime Kuma:
   • Gotify Server URL: For example, http://<your_server_ip> or https://<your_domain>
   • Gotify Token: Paste the token obtained from your Gotify.
   • Priority Level: Assign a priority to these notifications.
   • Click “Test” to ensure that Uptime Kuma can successfully send a message to your Gotify.
4. Assigning Notifications to Monitors:
   • Go to the “Monitors” section in Uptime Kuma.
   • Edit or create a new monitor.
   • Under “Notifications”, select your Gotify configuration.
   • Save the changes, and your Gotify Setup is now integrated with Uptime Kuma.

Tips for Optimizing Your Setup

• Use SSL/TLS: Secure your Gotify Setup and ensure safe data transmission.
• Regular Backups: Frequently back up your Gotify data directory to prevent data loss.
• Adjust Priorities: Utilize priority settings within your Gotify Setup so critical alerts receive the attention they deserve.

Conclusion
A well-executed Gotify gives you total control over your notification infrastructure, offering real-time alerts, data privacy, and endless customization options. By following the steps above, you’ll have a fully functional Gotify Setup, seamlessly integrated with Uptime Kuma for immediate uptime alerts and increased peace of mind.