Skip to content
    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:

    1. Installed — The agent is installed on the server.
    2. Registered — The agent has reached SeqOps and registered.
    3. Reporting — The agent keeps checking in and sends data.
    4. 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

    SymptomLikely causeWhat to do
    The agent isn't installed or isn't runningThe install command didn't complete, or the agent stoppedRun the install command from Server → Activation again, then check that the agent is running on the server.

    2. Registered

    SymptomLikely causeWhat to do
    Registration is rejectedThe registration values are no longer validUse Reset API Key on the server, then run the new install command.
    Registration is rejectedA value was copied incorrectlyCopy the install command from the activation wizard instead of typing it.
    The agent can't reach SeqOpsA firewall or proxy blocks outbound HTTPSSee Running the Agent Behind a Proxy or Firewall.

    3. Reporting

    SymptomLikely causeWhat to do
    The agent registered once, then went offlineOutbound access changed, or the agent stoppedRe-check the firewall and proxy, then check that the agent is still running.
    The agent flips between online and offlineAn unstable network path or an agent that keeps restartingSee 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

    We use cookies

    We use essential cookies to run this site. With your permission, we'd also like to use analytics cookies to see how the site is used, and functional cookies for chat and videos. Change your choice any time under Cookie settings. Read our Cookies Policy