Hosting limits
Quota, per-file and per-version limits, site names, blocked file types, versions and retention, and the hosted game server sandbox on 0x.limo.
The live limits are public. Use them as the source of truth in scripts:
curl -s https://api.0x.limo/v1/hosting/config{
"limits": {
"quota_bytes": 2147483648,
"max_file_bytes": 67108864,
"max_files": 5000,
"max_sites": 20,
"blocked_extensions": ["exe", "dll", "com", "scr", "msi", "msix", "bat", "cmd", "ps1", "vbs", "lnk", "reg", "so", "dylib", "app", "dmg", "pkg", "deb", "rpm", "appimage", "apk", "ipa", "jar", "sh"]
},
"sites_url": "https://{site}-play.0x.limo/sites/",
"tracker": "wss://play.0x.limo/p2p/tracker"
}0x whoami (or GET /v1/hosting/me) shows your own usage against these limits.
#Hosted sites
| Limit | Value on 0x.limo | When you exceed it |
|---|---|---|
| Storage quota per developer | 2048 MiB | 413 over your hosting quota (… MiB used of 2048 MiB, this version … MiB) |
| Largest file | 64 MiB | 422 upload refused: <path>: larger than 64 MiB |
| Files per version | 5000 | 413 a version has 1 to 5000 files |
| Sites per developer | 20 | 403 at most 20 sites per developer |
| Upload request body | 80 MB (front limit) | One file per PUT /v1/hosting/blobs/<sha256>, so the 64 MiB file limit applies first |
How the quota counts: it is the sum of the bytes of every version of every site you own, pending versions included. Files are stored once by hash, but each version counts in full. Versions cannot be deleted yet, so frequent large publishes use up the quota. Keep big assets in a version only when they change, or reuse a site, since the quota is per developer.
#Site names
- 3–40 characters:
a-z,0-9and-, not starting or ending with-. Names are globally unique: the first to create one owns it (409 that site name is taken). - Reserved: platform host names can't be taken, either as the name or as the first label of the site's host.
api,play,p2p,www,docs,sdk,npm,store,embed,sites,earth,war,lossantos,adminand others are reserved (409 that site name is reserved). - The name becomes the origin
https://<site>-play.0x.limo. Every site has its own origin, so one game can't read another game's storage, cookies or frames.
#Files
A version must have an index.html at its top. The service refuses:
- paths that are not plain relative paths (
.., absolute paths,//); - hidden files and directories (any segment starting with
.); - paths 0x writes itself:
x1.json,x1-sw.js,x1/…,swarm/…, and the reserved0x.json,0x-sw.js,0x/…; - the same path listed twice.
#Blocked file types
Hosted sites are for games, not for distributing software. Files with these extensions are refused: .exe .dll .com .scr .msi .msix .bat .cmd .ps1 .vbs .lnk .reg .so .dylib .app .dmg .pkg .deb .rpm .appimage .apk .ipa .jar .sh. Any other file type is published as-is, including every game data and asset format.
The CLI never uploads the following files, even if they are in your build directory: node_modules/, .x1/, .git/, swarm/, package.json, package-lock.json, 0x.config.json, server.mjs and .gitignore at the top level, and x1-iap.key at any depth.
#Versions and retention
- Each publish creates version
n+1. A version is pending until finalized, then final and immutable, served at/sites/<site>/<n>/for good. - Re-publishing exactly the same file list resumes the pending version instead of creating a new one.
- Finalized versions are kept. There is no delete call for versions or sites yet.
- Pages (
/and*.html) are servedCache-Control: no-cache, so a policy change reaches browsers. Every other file ispublic, max-age=31536000, immutable. - Paid games' sites are built origin-only: no swarm manifest, and nothing is seeded. Only owners can load them.
#Store listings
| Limit | Value |
|---|---|
| Submissions waiting for review at once | 10 per developer (429) |
| Capsule | PNG, ≤ 1 MiB |
| Screenshots | ≤ 6, PNG or JPEG, ≤ 2 MiB each |
| Trailer file | MP4 or WebM, ≤ 60 MB |
All fields: Listing fields.
#Hosted game servers
A server deployed with 0x deploy-server runs in a sandbox with these defaults on 0x.limo:
| Limit | Value |
|---|---|
| CPU | 1 CPU |
| Memory | 512 MiB |
| Processes | 128 |
| Writable files | /tmp only, 64 MiB (counted in memory). Everything else is read-only. |
| Logs kept | 5 MiB |
| Open files | 4096 |
| Bundle upload | ≤ 50 MB (compressed). Installed: ≤ 400 MB. |
| Running servers | 2 per developer (429 limit: 2 running servers per developer) |
| Network | Loopback only. The broadcast service and the platform API are forwarded in; nothing else is reachable. |
| App id | ^[a-z0-9][a-z0-9-]{1,40}$, and it must be one of your hosted sites |
Dependencies install with npm ci --ignore-scripts, or npm install without a lockfile. @0xlimo/* and any file:, link: or workspace: dependencies are packed into the bundle for you. A crash restarts the server, and socket.io clients reconnect by themselves.
#Rate limits
API calls are rate-limited per account and per address. A 429 carries Retry-After. 0x publish retries uploads that get 429 or 5xx, up to 5 times with backoff.
