Skip to main content

Installing Gotify with iGotify for iOS

Gotify is a self-hosted notification server that lets you send messages to devices and apps via a simple API. It’s great for server alerts, home automation, and custom scripts because you control delivery and history.

iGotify is the bridge that makes Gotify work with iOS push notifications. It listens to Gotify, translates messages, and forwards them to the SecNtfy app on your iPhone so you get real push alerts (iOS can’t poll in the background, so the bridge is required).

Once app is installed Set gotify and igotify domain in Nginx Reverse Proxy and Pangolin for domain with ssl login

Install Gotify

  1. ssh to folder where gotify app will live or use Komodo and create Stack
  2. Add docker-compose.yaml
    1. Add services: Gotify and iGotify, with ports exposed (e.g., Gotify 3030:80, iGotify 3031:8080)
    2. Persist data: Use a volume for Gotify (data:/app/data or ./gotify_data:/app/data)
    3. GOTIFY_DEFAULTUSER_PASS for the default admin
  3. Start the stack
  4. Check URLs: Gotify at http://<server-ip>:3030, iGotify at http://<server-ip>:3031/Version
  5. Login: Open Gotify, sign in as admin

 

Create Tokens for iOS app

  1. Login to Gotify in browser and got to Clients
  2. Create a Gotify client token by clicking New client (e.g., “igotify”).
  3. Copy token
  4. Add to iGotify env: GOTIFY_CLIENT_TOKENS: "cXXXXXXXX" inside yml file
    1. Adjust the URL to the domain url of Gotify


iGotify iOS App Setup

 

  1. Install iGotify app
  2. Enable local instance: In the app’s settings
  3. Connect to iGotify: Use http://<server-ip>:3031
  4. Get igotify app token: In the app, Settings → Development → copy the notification token (NTFY-DEVICE-XXXXXX).
  5. Add that token to the yml file
  6. Update compose
  7. Once everything is up and running, go to igotify app into settings
  8. Select Instance and click Edit
  9. Change the http://<server-ip>:3031 to https and point it to domain

Adding multiple devices Multiple tokens

Add each device’s SecNtfy token separated by semicolons.

Example:

Enviroment:
  SECNTFY_TOKENS: "NTFY-DEVICE-AAA;NTFY-DEVICE-BBB"
  GOTIFY_CLIENT_TOKENS: "cXXXX1;cXXXX2" (if using multiple Gotify clients)
  GOTIFY_URLS: "https://gotify1;https://gotify2" (if using multiple Gotify servers)