An agent's credential is too large
Weik.io 2026.2An agent's environments and projects need a larger credential than its bundle or the hub's message server accepts. The agent keeps its current credential and doesn't serve the environments and projects that don't fit.
| Kind | Severity | Who sees it |
|---|---|---|
agent- |
Error | Platform administrators |
What it means#
The agent serves more environments or projects than one credential can carry. Until you fix it, the agent keeps its current credential and doesn’t serve the environments or projects that the detail lists.
What raises it#
Each environment and project the agent serves adds permissions to its credential. The problem shows when the credential the agent needs crosses a limit:
- The hub’s message server accepts at most 4,096 permissions in one credential.
- An agent’s bundle from a release before 2026.2.2 accepts at most 64 KiB, permissions included, when it links to the hub.
The detail has the figures and ends with a command when the bundle is the limit. The problem shows while the agent is offline too.
What to check#
See the environments and projects the agent serves:
$ weikio describe agent <agent>How to fix it#
When the bundle is the limit, install a new bundle on the agent’s host. The agent is offline from when you write its new bundle until you install it, so do both steps together. First write the bundle:
$ weikio agent credentials <agent> --out <folder>Then copy the folder to the agent’s host and run sudo sh ./setup.sh in it.
When the message server’s limit is crossed, give the agent fewer environments with weikio agent set-capabilities, or fewer projects with weikio agent set-projects.