How to set up Gotify
· Updated 31 July 2026 · SparkBox team
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>:8880Create 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
That's Gotify live on SparkBox.
If something doesn't match what you see, post in d/sparkbox or hit us up on YouTube. Every SparkBox bug gets patched; every UX-stumble in this guide gets rewritten.
Questions, or did this not match your box?
Every guide here came from a real problem someone hit. If yours behaves differently, say so — that is how these get corrected, and how the fix gets prioritised.
We answer there rather than in a comment box, because that is where the people who have already solved it are.