Limits and defaults
Lists the limits and the default values that the platform enforces.
Last updated
On this page
Limits
Generated from the constants the platform enforces. Quota rows apply to an owner with no quota of its own; to raise one, send a request.
| Limit | Value | Applies to |
|---|---|---|
| Name | 1-40 lowercase letters, digits or '-', start with a letter, end with a letter or digit, no '--', and not be reserved (ws, env, api, admin, system, kl, bld-*) or look like an id; refused with 422 | workspace, environment and desk names |
| Service name | 1-40 lowercase letters, digits or '-', start with a letter, end with a letter or digit, no '--'. | environment services |
ttl_secs | 600 to 2592000 seconds; absent means never | environment, desk, workspace |
Snapshot ttl_secs | 3600 to 31536000 seconds (2592000 for a capsule's); never is for a snapshot you take only | take, capsule snapshot |
| Snapshot default life | 30 d taken · 1 d capsule · 7 d cut by the platform | every snapshot |
Capsule timeout_secs | 10 to 86400, default 300 | capsule create |
| Capsule size | cpu 1–8, memory_gb 1–32 | capsule create |
Capsule env | 64 variables | capsule create |
Capsule cmd | 256 arguments, 256 KiB in all | capsule create |
Capsule wait | 20000 ms per call | capsule wait |
| Secrets | 100 per store (a person, a team, or a person in a team), 64 KiB per value; names use A-Z, 0-9 and _, not starting with a digit | team, personal, and personal-in-team secrets |
| Pipelines | 50 per owner, 100 versions each | pipeline create, new version |
| Pipeline definition | 64 KiB, 50 jobs, 100 steps in a job | pipeline create, new version |
| Pipeline webhook | 256 KiB body, 30 calls per minute | webhook door |
| Git credential requests | 60 per minute for each token (a job, a capsule, or all workspaces of a person in one team) | git clone and git fetch over HTTPS |
| Volume name | 1 to 40 characters of a-z, 0-9 and -; refused with 422 | first push, saveTo |
| Version counter retries | 10 per request; then 409 | push of a named volume |
| Save wait | 300 seconds; then the job fails | pipeline job with saveTo |
| Save hold | 600 seconds after the job exits 0 | pipeline job with saveTo |
Pipeline after chain | 5 pipelines deep | after triggers |
| Trees | 8 per workspace | workspace trees |
| Packages | 100 per workspace, each attribute ≤ 64 characters | spec.packages |
| Package lock cache | 24 hours | pinned attr@version |
| Idle stop | 1800 s workspace or desk · 300 s environment with no awake desk | idle stop |
| Key resync | every 300 s | authorized keys |
| Default image | ghcr.io/kloudlite/kloudlite-workspace | workspace create |
Quota workspaces | 5 person · 20 team | default when no Quota names the owner |
Quota environments | 2 person · 8 team | default when no Quota names the owner |
Quota snapshots | 20 person · 80 team | default when no Quota names the owner |
Quota diskGb | 100 person · 400 team | default when no Quota names the owner |
Quota cpu | 36 person · 144 team | default when no Quota names the owner |
Quota memoryGb | 72 person · 288 team | default when no Quota names the owner |
Quota capsules | 5 person · 10 team | default when no Quota names the owner |
Fixed names and paths
| Name | Value |
|---|---|
| Global git ignore | .cache/, .direnv/ in ~/.config/git/ignore |
| Package pin forms | attr, attr@latest, attr@N, [email protected], [email protected] |
| Pending requests | One per owner per kind |
| Intercept grace | 30 s of an unreachable workspace before the real service comes back |
| Key and membership propagation | Immediate on change; resynced on the key resync beat above |
| ssh user | kd |
| Tree path | /home/kl/workspace |
| Home | /home/kl, the workspace's own volume; a clone or restore carries the whole home, credentials included, and it is always your own workspace |
| API | https://dev.kloudlite.io/v1 |
| Machine lost | 3 s without a heartbeat from a compute machine. An administrator can change it. |
| Copies of a volume | 2, on different storage machines |
| Block of a lost machine | 1 hour in the storage pool |
Volume tiers
The tier limits the disk speed of one volume. The platform sets the tier from what the volume belongs to. You cannot choose it.
| Tier | Reads and writes per second | Megabytes per second | Used by |
|---|---|---|---|
s | 400 | 25 | Workspaces, capsules, and benches |
m | 1200 | 60 | Environments |
l | 2400 | 125 | No kind yet |