Support
Help with ServerMage.
Updated October 12, 2026
Contact us
Email hello@theblackwell.app and a person will reply. It helps to include your iPhone model and iOS version, your server’s Linux system (for example Ubuntu 24.04), what you tapped and what happened. If setup failed, tap Copy Diagnostics on the error screen and paste the result into your email. It describes your server and the step that failed; read it first if you like, and remove anything you’d rather not share.
What you need
- An iPhone with iOS 18 or later.
- A Linux server running Ubuntu 22.04 or 24.04, Debian 12 or 13, Rocky Linux 9 or 10, or AlmaLinux 9, on an x86-64 or ARM64 processor.
- A user name and password or SSH key for that server, for an account that can use
sudo. ServerMage uses it only during setup and repair, and doesn’t keep it. - Your iPhone and the server on the same home network while you set it up and manage it.
ServerMage can’t reach my server
- Make sure your iPhone is on your home network, not on mobile data or a guest network.
- Check that ServerMage may use your local network: on your iPhone, open Settings › Privacy & Security › Local Network and turn on ServerMage.
- Make sure the server is switched on. If it is and ServerMage still can’t reach it, open the server in ServerMage and tap Repair over SSH. It finds out what’s wrong and shows you before changing anything, and fixes common problems such as Docker not running. Your apps and their data are kept.
- If your server’s address changed (for example after a router restart), give the server a fixed address in your router’s settings. ServerMage warns you when your server’s address is one the router can change.
Setup says my server can’t be used
Before changing anything, setup checks your server and tells you plainly why it can’t continue, for example an unsupported Linux system, or another program already using the port ServerMage needs. Nothing is installed in that case. If the reason isn’t clear, email us the diagnostics.
An app isn’t healthy
Open the app’s page in ServerMage. Restart fixes many problems, and Logs shows what the app reported. ServerMage never deletes an app’s data unless you ask it to, so restarting, updating, or removing and reinstalling an app keeps your data by default.
A music app can’t connect to Navidrome
Music apps need Navidrome’s full address, not just your server’s. Open Navidrome’s page in ServerMage and tap the address under Music apps to copy it, then add a server with that address and your Navidrome account in your music app. With remote access on, use the From anywhere address when you’re away from home.
I can’t find an app I already installed
When you add a service, apps already on that server are hidden so you don’t install one twice by accident. Tap Show already installed services under the list to see them, for example to install a second copy.
Notifications don’t arrive (Pro)
- In ServerMage, open Settings › Notifications and check that they’re on, and which kinds of events you chose.
- On your iPhone, open Settings › Notifications › ServerMage and allow notifications.
- Notifications are sent by your server, so it needs a working internet connection. ServerMage can’t yet tell you when a server has stopped responding altogether.
- Send a Test Notification in ServerMage’s notification settings checks the whole path for each server.
Purchases and subscriptions
- Pro on a new iPhone: sign in with the same Apple Account and tap Restore Purchases in ServerMage’s Settings.
- Change or cancel a subscription: in ServerMage, open Settings › Manage Subscription, or on your iPhone open Settings › your name › Subscriptions. Apple manages subscriptions, so we can’t change or cancel them for you.
- Refunds are handled by Apple at reportaproblem.apple.com.
- If Pro ends, ServerMage goes back to Free. Your apps keep running and nothing is deleted. For your security, remote access is turned off, and ServerMage offers to turn it back on if you get Pro again.
Removing ServerMage
To remove an app, open its page and tap Remove Service; its data is kept unless you choose to delete it. To remove ServerMage from a server altogether, open the server and tap Remove ServerMage from This Server. You can keep or remove its apps and their data. Docker and your own folders are always left alone.
More
Each app’s page in ServerMage has a Documentation button that opens that app’s official guide. How ServerMage handles your information is in our Privacy Policy.