Skip to content
Weik.ioDocs
2026.2
Try Weik.io

No agent serves the deployment

Weik.io 2026.2

No online agent runs the deployment, because no agent may run it or every agent it's placed on is offline. The detail shows which. Video

Watch: Sites and agents, 4:25

The video enrols an agent and runs its bundle on a host, then checks that the agent is online.

On this page
Kind Severity Who sees it
deployment-no-agent Error Everyone who can read the deployment

What it means#

The integration doesn’t run in this environment, because no agent may run it or every agent it was placed on is offline.

What raises it#

The problem shows when no online agent runs the deployment. A new installation gets two minutes for its first agents to report before the problem shows. The detail shows the first cause that applies, in this order:

  1. An agent that serves the environment and meets the requirements isn’t allowed to run the project.
  2. The agents that serve the environment and meet the requirements are draining.
  3. No agent that serves the environment meets the integration’s requirements.
  4. No agent serves the environment.

When every agent the deployment is placed on is offline, the detail lists those agents instead of a cause.

What to check#

See why the deployment is pending:

Terminal
$ weikio status <project>/<integration> --env <environment>

See the status and capabilities of the agents that serve the environment:

Terminal
$ weikio get agents --env <environment>

See the environment’s agents and its deployment counts per project:

Terminal
$ weikio describe environment <environment>

How to fix it#

Start an offline agent on its host, or fix the cause the detail shows. For causes 1 to 3, a platform administrator runs the matching weikio agent command:

Terminal
$ weikio agent set-projects <agent> <project>,<other-project>
$ weikio agent undrain <agent>
$ weikio agent set-capabilities <agent> os=linux environment=<environment>

set-projects and set-capabilities replace the agent’s whole list, so give every project and capability it should keep. When no agent serves the environment yet, enrol one with weikio agent enrol.

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