Skip to main content

Managing sites

Legacy: This page documents Filebase's IPFS tier. For new deployments, use the S3-compatible object storage tier with the s3.filebase.io endpoint.

Create a site​

  1. In the console, click Sites → Create Site.
  2. Pick a name (3–63 chars, globally unique).
  3. Either:
    • Upload now — drag a folder or CAR file.
    • Empty — create the site without content; deploy later.
  4. Click Create.

The site is live at https://<site-name>.myfilebase.site once the IPNS record propagates.

Update a site​

  1. Open the site in the console.
  2. Deploy New Version → Upload (a folder or CAR file).
  3. Click Deploy.

The IPNS record updates within ~1 minute. Visitors see the new content automatically — no cache invalidation needed.

For sites with many files, packaging into a CAR file is much faster than uploading individual files:

npx ipfs-car --pack ./dist --output site.car

# Upload via the S3 API with the import=car flag
aws --endpoint https://s3.filebase.com s3 cp ./site.car \
  s3://my-sites-bucket/site.car \
  --metadata 'import=car'

Then assign the resulting CID to the site:

curl -X PUT \
  -H "Authorization: Bearer $(echo -n "$KEY:$SECRET" | base64)" \
  -H "Content-Type: application/json" \
  -d '{ "cid": "<CID>" }' \
  https://api.filebase.io/v1/sites/my-site

Delete a site​

  1. Open the site in the console.
  2. Settings → Delete Site.

The IPNS name is freed, the URL stops resolving, and the underlying CID becomes unpinned (unless it's also pinned through a bucket).

What's next​