Troubleshooting
Agent Shows Offline: Step-by-Step Diagnosis
Find the stage where an offline agent stops, from installation to reporting, and fix it.
Start with the connection: most agent problems come from outbound access, registration values that are no longer valid, or an agent that isn't running.
The Stages
An agent has to pass each stage in order:
- Installed — The agent is installed on the server.
- Registered — The agent has reached SeqOps and registered.
- Reporting — The agent keeps checking in and sends data.
- Shown in dashboard — The server's data appears in SeqOps.
Find the first stage that isn't working and use its table below.
1. Installed
| Symptom | Likely cause | What to do |
|---|---|---|
| The agent isn't installed or isn't running | The install command didn't complete, or the agent stopped | Run the install command from Server → Activation again, then check that the agent is running on the server. |
2. Registered
| Symptom | Likely cause | What to do |
|---|---|---|
| Registration is rejected | The registration values are no longer valid | Use Reset API Key on the server, then run the new install command. |
| Registration is rejected | A value was copied incorrectly | Copy the install command from the activation wizard instead of typing it. |
| The agent can't reach SeqOps | A firewall or proxy blocks outbound HTTPS | See Running the Agent Behind a Proxy or Firewall. |
3. Reporting
| Symptom | Likely cause | What to do |
|---|---|---|
| The agent registered once, then went offline | Outbound access changed, or the agent stopped | Re-check the firewall and proxy, then check that the agent is still running. |
| The agent flips between online and offline | An unstable network path or an agent that keeps restarting | See Collecting Diagnostic Logs and contact support. |
Open a Support Ticket
If you've worked through every stage and the agent is still offline, contact support@seqops.io or use the Contact Us page. Include:
- •The server name and operating system
- •The stage where it fails
- •The exact error message
- •When it went offline, and any recent changes to the server or network
troubleshootingagentofflineconnectivitydiagnosis