Skip to content
Weik.ioDocs
2026.2
Try Weik.io

An agent is offline

Weik.io 2026.2

An agent that reported before hasn't sent a status for two minutes. Its integrations keep running within the environment's offline limit. Video

Watch: Watching the whole installation, 3:10

The video watches the whole installation from the Home and Observability pages, then from the Health page.

On this page
Kind Severity Who sees it
agent-offline Error Platform administrators

What it means#

An agent that has reported before no longer reaches the hub. Until it’s back, you can’t see what it runs or send it changes. Its integrations keep running for as long as the environment’s offline limit allows.

What raises it#

The agent hasn’t sent a status for two minutes. For a host that runs only a gateway, the row is about the gateway at that site instead.

When you’ve set allowed networks, the problem’s detail also shows that the agent’s address must be in those networks. If the agent last sent from an address outside those networks, the detail shows that address too.

What to check#

Read the agent’s last status and when it was seen:

Terminal
$ weikio describe agent <agent>

On the agent’s host, in its folder, check that the agent and its leaf node run:

Terminal
$ docker compose ps
$ docker compose logs --tail 50 agent

How to fix it#

If the agent has stopped, start it. Then check that the agent’s host can reach everything it connects to:

  • The two names of your Weik.io installation on port 443
  • The installation’s public address
  • The link’s address in the bundle’s leaf.conf

If the agent’s bundle was replaced, install the new one with its setup.sh. The problem clears when the agent reports again.

Sign in to the live demo

Sign in with the shared viewer account. It can open every screen of the example projects but can't change anything.

E-mail
viewer@demo.weik.io
Password
try-weikio-live-demo
Open the live demo