iGotify

iGotify

Docker app from GrafGenixs' Repository

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

# 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

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

Install iGotify on Unraid in a few clicks.

Find iGotify in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for iGotify Review the template variables and paths Click Install

Related apps

Explore more like this

Explore all

Details

Repository
ghcr.io/androidseb25/igotify-notification-assist:latest
Last Updated2026-07-17
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