selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
iGotify-Notification-Assistent logo

Self-host iGotify-Notification-Assistent

v1.6.0.1

Gotify-to-iOS push notification bridge via APNs

ReleaseOpen SourceMIT
Updated11 hours ago
LanguageC#
Setup difficultyModerate
MobileNative app
Stars
427
Port
8080 (iGotify Notification Assistant HTTP API)
Requires
Gotify server
Docker
ghcr.io/androidseb25/igotify-notification-assist
Install with Docker Compose
iGotify iOS app welcome screeniGotify iOS app external instance setup screeniGotify iOS app logged in and ready to receive notifications

What is iGotify-Notification-Assistent?

iGotify Notification Assistant is a self-hosted companion service that connects Gotify with iOS devices. It links to Gotify via WebSocket, encrypts incoming messages, and sends them through the SecNtfy service to Apple's push notification system for delivery to the native iGotify iOS app. The project offers two deployment methods: a Docker Compose stack running both Gotify and iGotify, and a Linux service installer for native installation on Debian 12+, Ubuntu 22.04+, RHEL 9+, Fedora 35+, Arch, and Alpine 3.17+. Key capabilities include encrypted push notifications, Gotify integration, FaceID support in the iOS app, multi-user and multi-instance support, and OIDC support for Gotify 3.0+. The iGotify service listens on port 8080 inside the container (mapped to 8681 by default), while Gotify listens on port 80 (mapped to 8680). Configuration uses environment variables including the required GOTIFY_DEFAULTUSER_PASS and optional connection settings for local instance mode. The project is MIT-licensed and actively maintained with recent releases.

Should you self-host iGotify-Notification-Assistent?

iGotify-Notification-Assistent scores 51/100 on selfhost.directory (how scoring works) and ranks #11 of 19 in Notifications. It has 427 GitHub stars.

It shipped 3 stable releases in the past year. The latest, v1.6.0.1, came out on 24 August 2026. New versions land roughly every 4 months.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is MIT-licensed and written mostly in C#.

Its closest alternative on selfhost.directory is ntfy (85/100, 35 133 stars). It scores higher overall, so compare the two before you pick. See iGotify-Notification-Assistent vs ntfy side by side.

Features

  • API endpoint UI (Scalar)Enabled by default via ENABLE_SCALAR_UI.
  • End-to-end encrypted push notifications
  • External instance mode (full functionality)Requires exposing port 8681.
  • Gotify WebSocket integration
  • Local instance mode (no external iGotify port)App/contact images don't work in this mode; manual setup required.
  • Multi-user and multi-instance support
  • Native iOS app with FaceID support
  • OIDC support for Gotify 3.0+
  • User management UIEnabled by default via ENABLE_USER_UI.

iGotify-Notification-Assistent README

How to install iGotify-Notification-Assistent

Install iGotify-Notification-Assistent with Docker Compose

Docker and Docker Compose (latest version recommended)
Environment variables
GOTIFY_DEFAULTUSER_PASS (required), GOTIFY_URLS, GOTIFY_CLIENT_TOKENS, SECNTFY_TOKENS (required for local instance), ENABLE_CONSOLE_LOG, ENABLE_SCALAR_UI, ENABLE_USER_UI

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

Includes both Gotify and iGotify services. iGotify port 8681 only needs to be exposed for external instance mode.

How to configure iGotify-Notification-Assistent

  • ENABLE_CONSOLE_LOGtrueEnable/disable console logging

    Enable/disable console logging

    values: true/false

  • ENABLE_SCALAR_UItrueEnable/disable the API endpoint page

    Enable/disable the API endpoint page

    values: true/false

  • ENABLE_USER_UItrueEnable/disable the User page for deleting devices from the database

    Enable/disable the User page for deleting devices from the database

    values: true/false

  • GOTIFY_CLIENT_TOKENSClient tokens from Gotify (e.g., cXXXXXXXX); semicolon-separated for multiple instances

    Client tokens from Gotify (e.g., cXXXXXXXX); semicolon-separated for multiple instances

  • GOTIFY_DEFAULTUSER_PASSPassword for the default Gotify user

    Password for the default Gotify user

  • GOTIFY_URLSGotify server URLs (e.g., http://gotify or https://mygotify.domain.tld); semicolon-separated for multiple instances

    Gotify server URLs (e.g., http://gotify or https://mygotify.domain.tld); semicolon-separated for multiple instances

  • SECNTFY_TOKENSSecNtfy tokens from the app (e.g., NTFY-DEVICE-XXXXXX); semicolon-separated for multiple instances

    SecNtfy tokens from the app (e.g., NTFY-DEVICE-XXXXXX); semicolon-separated for multiple instances

iGotify-Notification-Assistent releases & version history

FAQ

What are the minimum system requirements for the Linux service installation?

The Linux service requires .NET 10.0 which needs GLIBC 2.34 or higher. Supported distributions: Debian 12+, Ubuntu 22.04+, RHEL/CentOS/Rocky/Alma 9+, Fedora 35+, Arch Linux, Alpine 3.17+.

Can I run multiple Gotify instances with one iGotify installation?

Yes, you can configure multiple Gotify instances by separating values with semicolons in GOTIFY_URLS, GOTIFY_CLIENT_TOKENS, and SECNTFY_TOKENS environment variables.

What is the difference between external and local instance modes?

External instance requires both Gotify and iGotify to be publicly accessible, enables app/contact images and automatic registration. Local instance only requires Gotify to be public, doesn't expose iGotify port, but requires manual token configuration and doesn't support app/contact images.

How do I find my Notification Token?

Open the iGotify app, go to Settings, navigate to Development, and swipe left on Notification Token to reveal and copy it.

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…