Support

How to get help.

If you’re reading this from App Review: the contact address below is monitored.

Contact

Email [email protected] for anything: bugs, integration weirdness, feature requests, questions about the privacy model, or App Store reviewer queries.

There’s no support ticket system, no auto-reply bot, and no queue. Replies come from a human, usually within a couple of days. Please include:

iOS version (Settings → General → About → iOS Version)
iPhone model
The integration you’re having trouble with, and its version on your server
What you expected vs. what happened

Security disclosures: same address, but write “security” somewhere in the subject. Please don’t post vulnerabilities publicly until we’ve had a chance to fix.

Common things people hit

“Unreachable” on every endpoint

Means the app couldn’t open a TCP connection to any of the URLs you configured for that service, within ~3 seconds each.

Check that the URL works in Safari on the same phone, on the same network.
If you’re using a LAN URL, confirm your phone is on Wi-Fi and on the same subnet as the service.
If you’re using a VPN URL, confirm the VPN is connected.
iOS’s “Local Network Access” prompt: if you tapped “Don’t Allow”, Stacklight can’t reach LAN addresses. Toggle it back on in Settings → Stacklight → Local Network.

Certificate trust prompt keeps appearing

Self-signed certificates trigger a one-time trust prompt where Stacklight shows you the certificate’s SHA-256 fingerprint and asks you to confirm. After you tap Trust, the pin is saved and the prompt won’t reappear unless the certificate actually changes.

If it’s coming back every time:

You may have multiple URLs (Home / Away) on the same service that resolve to different certs. Trust each one once.
iCloud sync of pins takes a few seconds. On a fresh device you’ll re-trust once.
If your server rotates certs automatically (Caddy, Traefik, NPM with Let’s Encrypt) and the cert changes daily/weekly, you’ll get re-prompted on each rotation. The fix is to add the renewal-stable URL or trust the issuing CA on the device.

iCloud not syncing between iPhone and Watch / second device

Both devices have to be signed into the same iCloud account.
iCloud Drive needs to be on for the Apple ID (Settings → [your name] → iCloud → iCloud Drive).
Stacklight specifically needs iCloud enabled (Settings → [your name] → iCloud → Stacklight).
Sync usually lands within seconds but can take longer on first launch after install. CloudKit batches the initial pull.

Per-integration setup

Pi-hole

Pi-hole 5: web admin password. Pi-hole 6: app password (Settings → Web interface). Endpoint is the same URL you log into the admin UI with.

AdGuard Home

Web UI username + password, the same one you use to log in. If you’re running AdGuard with auth disabled, leave both blank.

TrueNAS Scale

API key from System Settings → API Keys → Add. Use HTTPS URL even if it’s self-signed. The cert prompt handles that.

Proxmox VE

API token (Datacenter → Permissions → API Tokens → Add). Stacklight needs both the Token ID (e.g. root@pam!stacklight) and the secret UUID that’s shown once when you create the token. Default port is 8006 over HTTPS.

Docker via Portainer

Portainer 2.11 or newer. Generate an API key from your user account settings inside Portainer. Use the “Use HTTPS” URL you log into the UI with.

Home Assistant

Long-lived access token (Profile → Security → Long-Lived Access Tokens). Use the URL you access HA at, including the port (typically 8123).

Plex

X-Plex-Token, easiest to grab from the Plex server URL itself (Settings → Network → Show advanced → List of IP addresses). The full how-to is on the Plex forums.

Jellyfin

API key from Dashboard → API Keys. The URL is the same one you log into Jellyfin at.

Sonarr / Radarr / Lidarr / Readarr

API key from Settings → General. Pick the right “Which *arr” in the service editor. That determines the API path and the vocabulary the detail view uses.

qBittorrent

WebUI username + password (Tools → Options → Web UI). If you’ve enabled the WebUI’s “Bypass authentication for clients on localhost” you still need to set WebUI auth creds for the iPhone to log in.

Transmission

Optional username + password (RPC settings). If your Transmission has no auth configured, leave both blank.

Immich

API key from your user profile inside Immich (Account Settings → API Keys). Endpoint is the host:port you use in a browser.

Paperless-ngx

API token from your user profile (avatar menu → My Profile → copy “Auth Token”, or generate one if blank).

Uptime Kuma

No credential. You do need a public status page configured (Status Pages → New Status Page), and the slug from the URL goes into the “Status page slug” field.

Synology DSM

DSM username + password. Two-factor authentication isn’t supported via the DSM API; if you have 2FA on the admin account, create a non-admin user for Stacklight.

Unraid

Unraid 7+ with the GraphQL API plugin. API key from the Unraid web UI (Settings → Management Access → API Keys).

Nginx Proxy Manager

Admin email + password. The same login you use for the NPM web UI.

OPNsense

API key and secret pair generated in System → Access → Users → (your user) → API keys → +. The secret is shown once; if you missed it, regenerate.

Overseerr / Jellyseerr

API key from Settings → General → API Key.

Gitea / Forgejo

Personal access token from Settings → Applications → Generate New Token. Scopes: at minimum read:repository and read:user.

Linux host (Glances)

Install Glances on your Linux box (pip install glances or use the apt/dnf package) and start it with glances -w. The URL is the same one you’d open in a browser (default port 61208). For the optional Reboot button, set up a webhook server like adnanh/webhook and paste its URL in the “Reboot webhook” field.

Bitaxe

No credential. The Bitaxe’s local IP works directly.

Scrutiny

No credential required for read-only use. Endpoint is the same as the web UI (default port 8080).

Reset everything

To wipe all local Stacklight data on a device: delete the app, wait a moment for iOS to clear the Keychain entries, then re-install. Your iCloud-synced service list will repopulate from your other devices if any have it; if you want a true clean slate, also turn off iCloud for Stacklight (Settings → [your name] → iCloud → Stacklight) and confirm “Delete from iCloud”.

Reporting a crash

Stacklight doesn’t send crash reports anywhere. If you hit a crash and can share what you were doing, email us. Apple’s crash logs are available on your device under Settings → Privacy & Security → Analytics & Improvements → Analytics Data. Look for entries starting with Stacklight. You can copy the text out and paste it into an email; nothing is shared automatically.

← Back to Stacklight