Repair the agent
Fix an unreachable server in Servor by repairing or reinstalling the agent from the top bar or server settings — get back to a connected, green status fast.
When a server shows unreachable, its agent has stopped talking to Servor. This page explains what that state means and how to bring the server back to connected by repairing or reinstalling the agent — usually in under a minute.
What "unreachable" means
Everything you do day-to-day — the web terminal, running commands, and live resource metrics — travels through the agent installed on the server, not through SSH. So when the agent stops responding, Servor marks the server unreachable even if the machine is otherwise fine and you can still SSH into it.
Common reasons the agent goes quiet:
- The server was rebooted and the agent service didn't come back up.
- The agent process crashed or was stopped.
- The machine lost outbound internet access (the agent connects out to Servor).
- The agent was uninstalled or its files were removed.
Unreachable is about the agent, not the box
A server can be perfectly healthy and still show unreachable — it only means Servor can't reach the agent. If SSH works but the server is unreachable in Servor, repairing the agent is the fix, not reaching for SSH.
Repair from the top bar
When one of your servers goes unreachable, Servor surfaces it in the top bar so you can act without hunting through your list.
Open the alert in the top bar
An unreachable server shows up in the top bar. Click it to open the repair prompt for that server.
Choose Repair the agent
Servor gives you a fresh install command — the same one-line command used when you first added the server. Copy it.
Run it on the server
Paste the command into a shell on the machine and run it. The installer replaces the agent with a clean build and restarts the service. It's safe to run over an existing install.
Watch it reconnect
Within a few seconds the server flips back to connected with a green status.
Repair from server settings
You can also repair from the server's own settings — handy if you're already on the server page.
Open server settings
In your servers, open the server, then click the gear icon to open settings. You'll find server info, surveillance thresholds, agent repair and delete here.
Choose Repair the agent
In the agent section, choose Repair the agent to get the reinstall command.
Run the command and wait
Run it on the machine as above. The server reconnects on its own once the agent is back up.
Reinstalling is safe
The install command is idempotent — running it again on a machine that already had the agent simply repairs it. You won't lose the server, its history, or its monitors.
When repairing isn't enough
If the agent reconnects and then drops again, or never comes back after reinstalling, the problem is usually on the machine or network side:
- Rebooted often? Make sure the agent service is enabled to start on boot (the installer sets this up; a custom-hardened box may block it).
- No outbound access? The agent needs to reach Servor over the internet. Check firewalls and egress rules.
- Firewall or SSH bootstrap trouble? Work through Connection issues for the full checklist.