iGotify

iGotify

Docker app from GrafGenixs' Repository

iGotify Notification Assistant is a lightweight service that complements Gotify Server by decrypting messages and triggering push notifications to iOS devices via Apple's APNs.

Overview

iGotify Notification Assistant is a lightweight service that complements Gotify Server by decrypting messages and triggering push notifications to iOS devices via Apple's APNs. This container is essential for enabling push notifications within the iOS app.

Setup Instructions:

  1. First, install and configure the official Gotify Server (Docker).
  2. Install iGotify. You only need to fill in the required information.
    Gotify URLS, Gotify Client Tokens and SecNtfy Tokens do not need to be filled in.
  3. Make sure that Gotify and iGotify are accessible from outside (only if you don't want them to be accessible only locally) with nginx or Traefik.
  4. Download the iGotify app for IOS and follow the instructions
    Further information can be found on the developer github page

This setup has been tested and confirmed to work effectively with NGINX Proxy Manager, ensuring a smooth operation for delivering notifications.

Donate with PayPal Stars Crowdin

iGotify

A notification assistant that bridges Gotify with iOS devices via Apple's APNs using the SecNtfy service.

Important: This project is not Gotify itself. iGotify is a companion service that enables push notifications for iOS devices. The notification payload is only forwarded through SecNtfy to Apple's APNs - no message content is stored on any intermediate server.

Features

  • End-to-end encrypted push notifications
  • Seamless Gotify integration
  • Native iOS app with FaceID support
  • Multi-user & multi-instance support

Installation

There are two ways to deploy iGotify:

Option 1: Docker (Recommended)

The Docker stack includes both Gotify and iGotify.

# Clone the repository
git clone https://github.com/androidseb25/iGotify-Notification-Assistent.git
cd iGotify-Notification-Assistent

# Configure environment
cp .env.example .env
# Edit .env and set GOTIFY_DEFAULTUSER_PASS
# For automatic registration, set GOTIFY_REGISTRATION_URLS too.

# Start the stack
docker compose up -d

Option 2: Linux Service

curl -sSL https://raw.githubusercontent.com/androidseb25/iGotify-Notification-Assistent/main/install.sh | sudo bash

Automatic Device Registration

For External Instance setup, set GOTIFY_REGISTRATION_URLS in the Assistant's environment to the Gotify base URL entered in the iOS app. Separate multiple URLs with semicolons.

If the public URL uses an access proxy, you can verify tokens through a separate route to the same Gotify instance. Use an entry such as https://gotify.example.org|http://gotify. The first URL is used for the WebSocket connection and the second only for token validation.

Upgrading to v1.6.1.0

Keep the existing Docker data volume mounted at /app/data when you update. The Assistant reloads saved registrations from that volume and resumes push delivery after the container restarts.

For External Instance, set GOTIFY_REGISTRATION_URLS before updating so the existing app can register another device or register again after signing out or reinstalling. An empty setting disables those registration requests. For a single Gotify instance, use the exact base URL entered in the app.

GOTIFY_REGISTRATION_URLS='https://gotify.example.org'

Manual Local Instance setup continues to use GOTIFY_URLS, GOTIFY_CLIENT_TOKENS, and SECNTFY_TOKENS.

Default Ports

Service Port
Gotify 8680
iGotify 8681

Documentation

For detailed documentation, visit the Wiki:

iOS App

Download on the App Store

or

AppStore Link

Bugs & Feedback

For bugs or feedback please send me a PM in Discord under the name sebakaderangler or fill out the issue form here on GitHub.

SecNtfy Status

Service Status

Contributing

See CONTRIBUTING.md for guidelines.

License

MIT License

Categories

Related apps

Explore more like this

Explore all

Links

Details

Repository
ghcr.io/androidseb25/igotify-notification-assist:latest
Last Updated2026-11-22
First Seen2024-05-01

Runtime arguments

Web UI
http://[IP]:[PORT:8080]
Network
bridge
Shell
sh
Privileged
false
Extra Params
--security-opt no-new-privileges:true --pull always

Template configuration

Host Port 1Porttcp

External port 8681 mapped to container port 8080

Target
8080
Default
8681
Value
8681
Volume 1Pathrw

Volume for API data

Target
/app/data
Default
/mnt/user/appdata/igotify/api-data/
Value
/mnt/user/appdata/igotify/api-data/
Gotify URLSVariable

URL to the Gotify server. example: http://gotify:80

Target
GOTIFY_URLS
Gotify Client TokensVariable

Client token from Gotify Client. example: cXXXXXXXX

Target
GOTIFY_CLIENT_TOKENS
SecNtfy TokensVariable

SecNtfy token from the app. example: NTFY-DEVICE-XXXXXX

Target
SECNTFY_TOKENS