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:
- First, install and configure the official Gotify Server (Docker).
- 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. - 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.
- 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.
Readme
View on GitHub
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:
- How it works - Architecture and token explanation
- Docker Installation - Full Docker setup with environment variables
- Linux Service - Native installation guide
- Reverse Proxy - NGINX Proxy Manager configuration
- First Start - First Start guide
- Roadmap - Planned features
iOS App
or
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
Contributing
See CONTRIBUTING.md for guidelines.
License
Categories
Related apps
Explore more like this
Explore allLinks
Details
ghcr.io/androidseb25/igotify-notification-assist:latestRuntime 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
External port 8681 mapped to container port 8080
- Target
- 8080
- Default
- 8681
- Value
- 8681
Volume for API data
- Target
- /app/data
- Default
- /mnt/user/appdata/igotify/api-data/
- Value
- /mnt/user/appdata/igotify/api-data/
URL to the Gotify server. example: http://gotify:80
- Target
- GOTIFY_URLS
Client token from Gotify Client. example: cXXXXXXXX
- Target
- GOTIFY_CLIENT_TOKENS
SecNtfy token from the app. example: NTFY-DEVICE-XXXXXX
- Target
- SECNTFY_TOKENS