Skip to content
Weik.ioDocs
2026.2
Try Weik.io

An agent's credential is too large

Weik.io 2026.2

An 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.

On this page
Kind Severity Who sees it
agent-credential-too-large 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:

Terminal
$ 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:

Terminal
$ 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.

Sign in to the live demo

Sign in with the shared viewer account, which can open every screen of the example projects and can't change anything.

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