Home / Help centre / Workspace settings
Workspace settings
What do pending, online and offline mean for a scan agent?
An agent is pending when you added it but it has not enrolled yet. Online means it has enrolled and checks in for work. Offline means it stopped sending its regular signals. The status and Last seen appear on each row in Settings → Scan Agents.
The short version
Pending means the agent exists but has not enrolled yet. Online: it is running and checking in for work. Offline: it has stopped checking in, so Cyberlop cannot hand it a scan, and you should look at the machine it runs on.
How it works in Cyberlop
Each agent in Settings → Scan Agents has a row with Name, Status and Last seen. Status follows the life of the agent.
| Status | What it means | What you do |
|---|---|---|
| pending | You added the agent, but nothing has used its one-time token yet | Run the container command on a machine in your network |
| online | The agent has enrolled and keeps checking in for work | Pick it as the Scan location on a profile |
| offline | The agent has stopped sending its regular signals | Check the container and its outbound connection |
On first start, the agent swaps its one-time token for a lasting key and flips to online. A regular signal, called a heartbeat, keeps it there. No heartbeat? Offline. The same live online and offline view comes back from the agents list in the API.
Last seen tells you when Cyberlop last heard from the agent, which helps you judge how long a machine has been quiet.
What to do next
Watch for online before you point a profile at an agent, because a profile pinned to an agent that has not enrolled yet has nowhere to run. Wait. If a row stays on pending, read why an agent is stuck on pending. If it drops to offline, read why an agent shows offline.
You can also see how to check an agent's status and what Last seen shows.
Related questions
- How do I see whether my scan agent is online?
- How do I see when my scan agent last checked in?
- Why is my scan agent stuck on pending?
- Why does my scan agent show as offline?
- How do I add a self-hosted scan agent?
Cyberlop self-hosted scan agents: scan private apps from inside your network
Step-by-step, with annotated screenshots.
Updated · Back to the help centre
Still stuck?
Tell us what you see on screen and an engineer will help you sort it out.