ServerMage Coming soon

On your server

What ServerMage can and can't do on your server.

This page is for anyone who wants to know exactly what they're letting onto their server, and for the friend who set it up for them. If anything here is unclear, or you find the Agent doing something this page doesn't say, please tell us.

What the Agent can access, and why

To install and look after apps, the Agent needs real access to your server. Here's all of it:

The Agent runs as root inside its container, because Docker and /opt/servermage require it. Its container has no shell or package manager, only the Agent program itself.

What it changes on your server

What it never does

Every internet address it contacts

Your server makes these connections because of ServerMage. You can watch for them, or block anything you don't use.

During setup only (once, over SSH, when you add the server): if Docker isn't installed yet, setup downloads it from Docker's official repository, download.docker.com, and installs the Agent from ghcr.io.

The apps themselves make their own connections, under their own settings. For example, Immich downloads its search models and Plex signs in to plex.tv. ServerMage doesn't add any.

What setup does

When you add a server, the app signs in over SSH once and runs two short scripts:

After that, the app forgets your password. SSH is only used again if you ask the app to repair or remove ServerMage.

You can read the scripts before you add a server. They're the exact files the app runs: the check, the install and the removal, with their SHA-256 checksums.

Removing it

"Remove ServerMage from This Server" in the app signs in over SSH and removes the Agent, its helpers and the firewall rules setup opened: port 47800, and mDNS if setup was the one that opened it (a rule your server already had stays). You choose whether its apps go too, and whether their data and backups in /opt/servermage are deleted. It never removes Docker, your other containers or your own folders.

Check it yourself

If you're comfortable with a terminal, you can confirm what's on this page:

Questions or a problem

If you think you've found a security problem, or the Agent doing anything this page doesn't describe, email hello@theblackwell.app. We read every message and will reply.