Support
Get help with Chorey.
Chorey is a client for a server you run yourself, so most issues come down to getting the app and the server talking to each other. Start here.
Getting started
Chorey needs a running server before the app can do anything — it doesn't work standalone. The server is a single Docker container, documented in full in the project README, including a five-minute setup on a Raspberry Pi, a NAS, or any small always-on machine on your network.
Read the setup guide on GitHub →
Frequently asked questions
Do I need to create an account?
No. The first time you open your server's web dashboard, you create a parent profile directly on your own instance — there's no Dark Studios account, and no separate sign-up for the iPhone, iPad, or Apple TV app. The app connects using an API key you generate yourself from that dashboard.
How do I get an API key?
Sign in to your web dashboard as a parent, go to Manage users → API keys, and create one. The full key is shown once — copy it straight into the app when it asks for it. If you lose it, revoke it and create a new one; nothing else needs to change.
What platforms are supported?
iPhone and iPad on iOS/iPadOS 17 or later, Apple TV on tvOS 17 or later, and any modern browser for the web dashboard and Child Portal. The iPhone/iPad app also runs on Apple Silicon Macs as an iOS app.
Where does my data live?
On your own server, in a single SQLite file, for as long as you keep the container running. Dark Studios doesn't operate a server for Chorey and has no access to your household's data.
What does Face ID protect?
It locks the parent view on a shared iPhone or iPad, so a child using the same device can't wander into chore editing or reward settings. It's processed entirely on-device by iOS — nothing about it is sent anywhere.
Troubleshooting
The app can't connect to my server
Double-check the server address you entered, including whether it's http:// or https://, and that the port matches what your server is running on (5152 by default). If your server is on the same network, make sure the device isn't on a different Wi-Fi network or VLAN that can't reach it.
"Parent sign-in" won't offer a passkey option on the shared tablet
This is expected on a plain local-network address. Passkeys require a secure context — either https:// or localhost — so they won't appear when the Child Portal is opened over a bare LAN IP like http://192.168.1.20:5152. Put a reverse proxy with HTTPS in front of your server (Caddy, Traefik, or Nginx with Let's Encrypt are all documented options) to enable passkeys everywhere. Password sign-in still works over plain HTTP in the meantime.
Face ID isn't prompting
Check that Face ID is enabled for Chorey under iOS Settings → Face ID & Passcode. If it was declined once, iOS won't ask again automatically — it needs to be re-enabled there.
Still stuck?
Open an issue on GitHub with what you're seeing, or email the studio directly.