Storing and sharing files

The **Storage** page (in the top menu, or [zaryn.xyz/storage](/storage)) is where everything you keep on Zaryn comes together: your repositories, the files you share by link, and your packages, each with how much of your plan it uses. ## Upload a file and share the link 1. Open **Storage**. 2. Drop the file onto **Upload a file**, or click it and choose the file. You can pick several at once. 3. When it's done, press **Copy link** and send the link to whoever needs it. That's all. The person you send it to doesn't need an account. The link looks like this: ```text https://ipfs.io/ipfs/bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi?filename=report.pdf ``` Your files stay under **My files**, newest first, with **Copy link** and **Open** next to each one. > **Files here are public.** Anyone who has the link can open the file, and anyone who has opened it may keep a copy. Don't upload passwords, private photos, contracts or anything else you wouldn't post publicly. For private work, use a [private repository](/docs/en/encrypted-repositories). ## Why the link keeps working Files are kept on IPFS, a public network of computers that find files by **what they contain** instead of **where they are**. Each file gets an ID made from its contents (a *CID*, shown under the ▾ button next to the file). - The link always opens exactly that file. Nobody, Zaryn included, can swap it for something else. - If you change the file and upload it again, the new version gets a new ID and a new link. The old link still opens the old version. - Uploading the same file twice doesn't use space twice. Need one link that always shows your *latest* version? That's an **address you can update** (IPNS), under **Advanced** on the Storage page. ## How much space you have | | Free | Premium | |---|---|---| | Files you share by link | 500 MB, up to 50 files | much more, see [plans](/billing) | | Repositories | 2 GB, files up to 250 MB | more | | Packages | 500 MB | more | The bars at the top of the Storage page show what you've used. When a bar turns amber you're past 75%, and Zaryn sends you a notification when you reach a limit. ## Remove a file (stop hosting) Open the ▾ menu next to the file and press **Stop hosting**, then confirm. The file no longer counts against your space and Zaryn stops keeping it online. Because IPFS is a shared network, a copy someone else made may keep working for a while; that's why private things don't belong here. ## For developers The same thing over the API, with a [personal access token](/settings) that has the `pin:write` scope: ```bash # upload: the response has the cid and a ready link curl -X POST "https://api.zaryn.xyz/v1/pins?name=report.pdf" \ -H "Authorization: Bearer $ZARYN_TOKEN" \ --data-binary @report.pdf # list your files and your space curl -H "Authorization: Bearer $ZARYN_TOKEN" https://api.zaryn.xyz/v1/pins # stop hosting one curl -X DELETE -H "Authorization: Bearer $ZARYN_TOKEN" https://api.zaryn.xyz/v1/pins/<cid> ``` Each upload comes with a receipt signed by the server (which file, how big, when) that anyone can check later. The **Advanced** tools on the Storage page cover the rest: checking a file against public gateways, linking a file to the commit it was built from, manifests for AI agents, releases and datasets, and IPNS addresses. How Zaryn keeps files available across servers is in [Pinning and IPFS Cluster](/docs/en/pinning-and-cluster).