# Limits

Every size, count, time and rate limit Sailfork enforces, with the real numbers.

## How to read this page

A limit that is hit fails with a message that names it. A rate limit answers `429`, usually with a `Retry-After` header: wait that many seconds. A size limit fails with a message that says the number. Sizes in GiB, MiB and KiB are binary: 1 GiB is 1,073,741,824 bytes.

Plan allowances for storage and agent changes are on [Plans, billing and usage](https://sailfork.com/docs/billing).

## Repositories and pushes

| Limit | Value |
| --- | --- |
| Largest pack in one push | 3 GiB. The error names the number it enforces |
| Largest single object in a pushed pack, after inflating | 256 MiB, whether a whole object or the result of a delta |
| Objects in one pack | 250,000,000 |
| Inflated bytes in one pack, all objects together | 1 TiB |
| Longest delta chain | 4,095 |
| Repository name | 1 to 100 letters, digits, `-`, `_` and `.`, not ending in `.git` |
| Repository description | 350 characters |
| Branches a contributor without Write may hold in one public repository | 20, all under `contrib/<handle>/` |
| Largest push from a contributor without Write | 256 MiB |

## Git LFS

| Limit | Value |
| --- | --- |
| LFS objects in one repository, all together | 1 TiB, within the plan's storage |
| One LFS object | 100 GiB |
| Objects in one LFS batch request | 1,000 |
| Upload batches and verify calls per person | 60 a minute |
| An offered upload that is not verified | Expires after 1 hour |

A batch over the repository allowance answers `507`. Objects that no reachable pointer names are kept until an owner deletes them.

A push over a limit fails with a line such as `the pack is over the <n>-byte push limit (SAILFORK_PUSH_MAX_PACK_BYTES)` or `an object in the pack is <n> bytes, over the <n>-byte object limit`. Push a large history in parts, or remove the large file from history.

## Accounts, tokens and sign-in

| Limit | Value |
| --- | --- |
| Handle | 1 to 39 lowercase letters, digits and hyphens, not starting or ending with a hyphen |
| Name | 1 to 100 characters |
| Password | 12 to 128 characters in the sign-up form. The server accepts 8 to 128 |
| Email address | 254 characters |
| Browser session | 30 days |
| Email verification link | 24 hours. A new one can be sent once a minute |
| Password reset link | 1 hour, one use, newest link only |
| Second step at sign-in | 5 minutes and 5 attempts to finish |
| Recovery codes | 10, each used once |
| SSH key | ed25519, ECDSA, or RSA of 2048 bits or more. Title 1 to 100 characters |
| Passkey name | 64 characters |
| Account deletion | Takes effect 14 days after you confirm |
| Organization deletion | Takes effect 14 days after you confirm |
| Repository deletion | Takes effect 14 days after you confirm |
| Organization or repository invitation | Expires after 7 days |
| Team name | 1 to 60 characters. Slug 1 to 60 letters, digits and hyphens |
| Audit log | Kept for 730 days |

### Access tokens

| Limit | Value |
| --- | --- |
| Token name | 1 to 100 characters |
| Scopes on one token | 32 |
| Repositories one token can be limited to | 100 |
| Token created by `sailfork auth login` | 90 days |
| Token created in Settings | 7, 30, 90 or 365 days. The CLI and API also allow no expiry |

A token made by another token cannot outlive it. See [Access tokens](https://sailfork.com/docs/tokens).

## Rate limits

Routes that are costly or open to anyone count requests in one-minute windows and answer `429` past the limit. [Rate limits](https://sailfork.com/docs/rate-limits) lists every one, what a `429` looks like and how to back off.

## Paging and result caps

| Limit | Value |
| --- | --- |
| Pull requests and issues, `limit` | 1 to 100, default 30 |
| Caissons, `limit` | 1 to 200, default 30 when paging |
| Code search, `limit` | Default 20, at most 100 |
| Code search query | 256 characters |
| Caisson `grep` and `find`, `--limit` | 1 to 2000, default 200 |
| Releases per page | 30 |
| `sailfork token list`, `--limit` | Default 30 |

Lists page with `nextCursor` and `cursor`. See [the REST API](https://sailfork.com/docs/api#paging).

## Attachments and releases

| Limit | Value |
| --- | --- |
| Attachment on an issue or pull request | 100 MiB each |
| Attachment uploads per person | 2 GiB in a rolling day |
| Attachment file name | 200 characters |
| Release asset | 2 GiB each |
| Assets on one release | 1,000 |
| Release asset uploads per person | 10 GiB in a rolling day |
| Release notes | 125,000 characters |
| Release title | 256 characters |
| Release tag | 255 bytes |

## Caissons

| Limit | Value |
| --- | --- |
| One file write | 10 MiB |
| Title | 4 to 200 characters |
| Scope entries on one caisson | 1 to 50 |
| Path rules in a caisson policy | 50 |
| Live caissons per repository | 8 by default. An owner can set 1 to 64 |
| Idle time before a caisson closes | 120 minutes by default. An owner can set 5 to 1440 |
| Files one batch may touch | 2,000 |
| Reads in one batch | 100 |
| Uncommitted edits a sandbox may take from a caisson | 128 MiB |

Run `sailfork caisson policy` to see the limits that apply to you. See [Caissons](https://sailfork.com/docs/caissons).

## Sandboxes

| Limit | Value |
| --- | --- |
| CPUs | 1 to 256, default 2 |
| Memory | At least 256 MB, default 2048 MB |
| Disk | 1 to 1024 GB |
| Lifetime | 1 to 1440 minutes, default 60 |
| One command | 120 seconds by default, at most 3600 |
| Wait for a host with room | 60 seconds by default, at most 600 |
| Standard input to a command | 1 MiB |
| Output kept from a command | 1 MiB |
| File read or written through the API | 16 MiB |
| Environment variables per sandbox | 100 |
| Sandboxes per list call | 200 |

A command that runs out of memory exits with 137 and the sandbox stays up. A command that hits `--timeout` exits with 124. See [Sandboxes](https://sailfork.com/docs/sandboxes).

## Hosted compute

| Limit | Value |
| --- | --- |
| Running vCPUs on Sailfork's hosts, per account | 64 by default, 1 to 256 |
| Spend in a UTC month | No cap unless the owner sets one |

Work past a cap waits in the queue and its status names the cap. The owner sets both under Settings, CI. See [Hosted compute](https://sailfork.com/docs/billing#hosted-compute).

## CI

| Limit | Value |
| --- | --- |
| Workflow file | 1 MiB |
| Job timeout | 360 minutes unless the job sets `timeout-minutes` |
| Lifetime of the sandbox that runs one execution of a workflow | 24 hours |
| Lines kept per step | 50,000 |
| Jobs one matrix may produce | 256 |
| Secrets per repository | 100, each 1 byte to 48 KiB |
| Artifact | 512 MiB each, 100 per run, 2 GiB per run |
| Artifact retention | 30 days |
| Run log retention | 90 days |
| Cache | 10 GiB per repository and per entry, least recently used evicted first |
| Cache entry not restored | Expires after 7 days |
| Times a run execution is claimed again after a worker stops | 3 |

See [CI](https://sailfork.com/docs/ci).

## Organizations and billing

| Limit | Value |
| --- | --- |
| Organization handle | 1 to 39 lowercase letters, digits and hyphens |
| Organization name | 1 to 100 characters |
| Organization tagline | 200 characters |
| Organization location | 100 characters |
| Organization website | 200 characters |
| Required approvals in merge rules | 0 to 6 |
| Free plan storage | 5 GiB |
| Free plan agent changes | 10,000 a month |

See [Organizations](https://sailfork.com/docs/organizations) and [Plans, billing and usage](https://sailfork.com/docs/billing).

---

Every docs page: https://sailfork.com/llms.txt
