SparkBox / Guides / Gotify

Gotify: open it, first login, settings, fixes

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. This is the short card for it — the two minutes after you press Enable, and the page to come back to when something is off.

SparkBox Apps page — one-click install cards for every module
SparkBox Apps page — one-click install cards for every module

Open it

Dashboard → Apps → Gotify → Open. The direct address on your network is:

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

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

SparkBox dashboard login screen
SparkBox dashboard login screen

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.

Any password the installer generated for you is under Settings → Passwords; the Open button offers to copy it.

Worth knowing

  • 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

When it breaks

If it will not open, check the app card first — a red dot means it is restarting or unhealthy, and this walkthrough reads the reason from its log. Tom AI on the dashboard can do the same for you.

Where your data lives

/opt/sparkbox/modules/gotify/config/

Included in the dashboard's Backup by default. Restoring that backup on a fresh install brings Gotify back exactly as it was.

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.

Ask in the community →

We answer there rather than in a comment box, because that is where the people who have already solved it are.

About this page: Rendered from the app's own manifest in SparkBox, so the ports, settings and first-login steps match the version you are running. If something does not match what you see, say so in d/sparkbox — the manifest gets fixed and every copy of this page with it.