0xDocs 0x.limo

Docs / Getting started

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:

bashtested
curl -s https://api.0x.limo/v1/hosting/config
json
{
  "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

LimitValue on 0x.limoWhen you exceed it
Storage quota per developer2048 MiB413 over your hosting quota (… MiB used of 2048 MiB, this version … MiB)
Largest file64 MiB422 upload refused: <path>: larger than 64 MiB
Files per version5000413 a version has 1 to 5000 files
Sites per developer20403 at most 20 sites per developer
Upload request body80 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-9 and -, 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, admin and 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 reserved 0x.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 served Cache-Control: no-cache, so a policy change reaches browsers. Every other file is public, 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

LimitValue
Submissions waiting for review at once10 per developer (429)
CapsulePNG, ≤ 1 MiB
Screenshots≤ 6, PNG or JPEG, ≤ 2 MiB each
Trailer fileMP4 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:

LimitValue
CPU1 CPU
Memory512 MiB
Processes128
Writable files/tmp only, 64 MiB (counted in memory). Everything else is read-only.
Logs kept5 MiB
Open files4096
Bundle upload≤ 50 MB (compressed). Installed: ≤ 400 MB.
Running servers2 per developer (429 limit: 2 running servers per developer)
NetworkLoopback 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.