How to set up Gotify

Send and receive push notifications. This guide covers how to access it, log in for the first time, configure the basics, and where its data lives so you can back it up.

1. What is Gotify?

A simple self-hosted push notification server. Send notifications from your scripts, services, and automations to your phone or browser with a clean REST API.

2. How to access it

Once it's enabled, Gotify runs on your SparkBox at:

http://<your-NAS-IP>:8880

Create an app token in the web UI to start sending notifications via the API

3. First login

Login as admin with the password SparkBox generated for you at install time. Find it in state/gotify-admin-password.txt or click the Gotify launcher tile in the dashboard. Create an app token (right-side Create Application) to start sending notifications via the API.

If it instead asks for a password you didn't set, check Settings → Passwords in your SparkBox dashboard — every auto-generated credential is listed there.

4. Tips

• Create an application token and use the REST API to send notifications from scripts
• Install the Gotify Android app for real-time push notifications on your phone

5. Where your data lives

Gotify's config and persistent data are stored on the SparkBox host under:

/opt/sparkbox/modules/gotify/config/

Backups via the SparkBox dashboard's Backup tile include this directory by default, so a single restore brings Gotify back to its current state on a fresh install.

Next steps