Back to Blog
team@tinypod.app

Self-Hosting Gotify: Push Notification Server

Gotify is a simple, self-hosted push notification server. Send and receive notifications via REST API with a clean web UI.

gotifynotificationspushapi

Gotify vs Ntfy


Both are self-hosted notification servers:

  • Gotify: More traditional client-server model, Android app, WebSocket delivery
  • Ntfy: HTTP-based, iOS and Android, topic-based

  • Ntfy is simpler for one-off notifications. Gotify is better for structured application notifications with priority and history.


    Features


    REST API

    Send notifications with a simple POST:

    curl -X POST https://gotify.example.com/message -H 'X-Gotify-Key: app-token' -F 'title=Alert' -F 'message=Server disk 90% full' -F 'priority=8'


    Web UI

    Browse notification history, manage applications, and configure settings.


    Android App

    Real-time push notifications via WebSocket. No Google Play Services required (uses WebSocket, not FCM).


    Applications and Clients

    Create separate applications for different notification sources. Each gets its own token.


    Plugins

    Extend Gotify with plugins for custom behavior.


    Use Cases


  • Server monitoring alerts
  • CI/CD pipeline notifications
  • Cron job status reports
  • IoT device alerts
  • Application error notifications

  • Deployment


    1. Deploy Gotify on TinyPod

    2. Create applications (tokens) for each notification source

    3. Install Android app

    4. Start sending notifications from scripts


    Resources: 1 CPU, 128 MB RAM. Extremely lightweight.