No agent serves the deployment
Weik.io 2026.2No 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.
This part of the video couldn't be loaded.
| Kind | Severity | Who sees it |
|---|---|---|
deployment- |
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:
- An agent that serves the environment and meets the requirements isn’t allowed to run the project.
- The agents that serve the environment and meet the requirements are draining.
- No agent that serves the environment meets the integration’s requirements.
- 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:
$ weikio status <project>/<integration> --env <environment>See the status and capabilities of the agents that serve the environment:
$ weikio get agents --env <environment>See the environment’s agents and its deployment counts per project:
$ 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:
$ 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.