# Thunderstore

> thunderstore.io | Storage; 1 record: free tier, limits, identity cost and evidence.

HTML https://fshy.ajam.dev/p/thunderstore/ | JSON https://fshy.ajam.dev/api/v1/entity/thunderstore.json | how to read a record: https://fshy.ajam.dev/llms-full.txt

## Thunderstore

- `storage/thunderstore` | qualifies-with-caveat | evidence reported | binding none | category registry
- identity a placeholder: card and phone unknown | verified 2026-10-21 (inherited) | stale on 2026-11-05
- url https://thunderstore.io
- free tier: 5,242,880,000 bytes (~5 GB) per package zip — documented as a soft limit that staff will raise on request; server default in source is REPOSITORY_MAX_PACKAGE_SIZE_MB=500. No per-team total quota; the only total cap is a global server-wide REPOSITORY_MAX_PACKAGE_TOTAL_SIZE_GB=1000. | unit: GB | metered on: unstated | read on: 2026-10-21 | source: [1]
- per-object cap: not stated | source: [1] | note: not stated
- retention: not stated | source: [1] | note: not stated
- egress: Free and CDN-fronted: download URLs 302 to ccdn.thunderstore.io with `Cache-Control: max-age=2678400`, `Server: cloudflare`, no auth. | metered: no
- identity: email
- interface: rest, rclone, cli
- limits note: 5 GB/zip soft cap; package must be a valid zip with manifest.json + icon.png 256x256 + README.md at root; per-game community listing required; uploads land in a moderation queue; source shows a global 1000 GB server cap shared by the whole platform (not per-user) which would reject new uploads if ever hit.
- interface detail: rest
- tooling: Package upload via multipart POST to /api/experimental/submission/upload/ (thunderstore-cli, tcli); metadata read via /api/experimental/package/. No rclone backend, CLI wrapper exists: github.com/thunderstore-io/thunderstore-cli.
- composes with: Unlimited packages x 5 GB each. Team is the ownership unit, one user can create many teams; nothing in the source caps packages per team. 20 packages = 100 GB, 200 = 1 TB, all on a free account.
- reliability: Packages surviving as 'mods' for a real game community; orphaned/garbage packages are routinely delisted, which deletes files.
- notes: the same as the free tier
- evidence:
  - [1] 2026-10-21: 'Currently there's a maximum package size limit of 5 242 880 000 bytes (or roughly 5 GB), but this is a soft-limit and can be increased if needed'
  - [2] 2026-10-21: REPOSITORY_MAX_PACKAGE_SIZE_MB=(int, 500), REPOSITORY_MAX_PACKAGE_TOTAL_SIZE_GB=(int, 1000)
  - [3] 2026-10-21: MAX_PACKAGE_SIZE / MAX_TOTAL_SIZE enforcement
  - [4] 2026-10-21: upload form states '10GB max'
  - withheld 2026-10-21: probe: GET thunderstore.io/package/download/BepInEx/BepInExPack/5.4.2305/ -> 302 to ccdn.thunderstore.io/...zip
  - withheld 2026-10-21: probe: GET ccdn.thunderstore.io/...zip Range 0-10 -> 206, Content-Range bytes 0-10/669238, Cache-Control max-age=2678400
- sources:
  - [1] https://wiki.thunderstore.io/mods/creating-a-package
  - [2] https://raw.githubusercontent.com/thunderstore-io/Thunderstore/master/django/thunderstore/core/settings.py
  - [3] https://raw.githubusercontent.com/thunderstore-io/Thunderstore/master/django/thunderstore/repository/package_upload.py
  - [4] https://thunderstore.dev/package/create/