IPFS-boot

September 10, 2025 ยท View on GitHub

Where to pin

As of writing there are two suggestions

  • Filebase - start uploading with just email
  • Storacha - wants email and card on file then start uploading

If you want to read more about IPFS pinning see here and gateways

Storacha is a fine place to pin your app but their gateway will not serve the bootloader due to csp headers

How to configure

The contents of example.env look like this

pin_api=
pin_token=
pin_filebase_bucket=abc123
pin_filebase_access=abc123
pin_filebase_secret=abc123
pin_storacha_email=user@email.com
pin_storacha_space=did:key:abc123
  • run cp example.env .env and open .env to edit
  • if pin_api is set the native ipfs upload method will be attempted (slow)
  • if pin_filebase_bucket is set the filebase method will be used (fast)
  • if pin_storacha_email is set storacha will be used (fast)
  • if more than one is set they both pin = more peers

Also

Storacha does the login by click link in email flow, to skip future logins add /root/.config/w3access when running the container

docker run --rm -i --platform=linux/amd64 \
  -v /tmp/w3access:/root/.config/w3access \
    -v ./dist:/root/dist --env-file .env ipfs-pin

License

MIT