Platform

Platform overview How it works Authorization testing Evidence & reports Private scanning Integrations

Solutions

Security agencies Product teams Regulated industries Partner programme

Learn

Blog Knowledge hub Compare

Resources

Pricing Documentation Help centre FAQ Security & data What we haven’t proved

Company

About Contact Careers Sign in to the platform Start a $199 pilot →

Home / Help centre / Workspace settings

Workspace settings

How do I see whether my scan agent is online?

Quick answer

Open Settings, choose Scan Agents and read the Status column for your agent. It shows pending, online or offline. An agent that stops sending heartbeats shows as offline. Scripts can read the same status from the agents endpoint.

Steps

The table has four parts: Name, Status, Last seen and an actions column.

STEPS

What each status means

The three states are simple.

StatusMeaning
pendingAdded in Cyberlop, but not started yet
onlineRunning and sending heartbeats
offlineStopped sending heartbeats

Good to know

An online agent also raises your concurrent scan limit, since it brings its own capacity. An offline one does not help.

Offline usually means the container stopped, the host lost power, or outbound HTTPS is blocked. Start the container and refresh the tab. If it stays offline, check that the host can reach app.cyberlop.com on port 443.

The API shows live status too. GET /api/agents lists agents with their online or offline state, and needs the profile:read permission. That helps if you want to chart agent health yourself.

For the meaning of each state in more depth, see the status guide. To check timing, read when an agent last checked in. We are here on the contact page if the row never changes.

Check the tab before you schedule a big internal run, and again after any maintenance on the host. A pending row after a long wait usually means nobody has run the command yet, which is worth a quick message to whoever owns the machine. Add the check to your release routine, so that a dead agent never surprises a Friday release or a late-night scheduled run that nobody is awake to watch.

Keep screenshots out of tickets if they show the token. The status table does not hold it, but the Add agent screen does.

Full tutorial

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.