Skip to main content

Managing sites

Create a site​

  1. In the console, click Sites → Create Site.
  2. Pick a name (3–63 chars, globally unique).
  3. Input the CID.
  4. Click Create Site.

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. Select Update CID and enter the new CID.
  3. Click Update Site to confirm and publish the change.

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 POST \
  -H "Authorization: Bearer <api-key>" \
  "https://rpc.filebase.io/api/v0/name/publish?arg=/ipfs/Qm...&key=<site-name>.myfilebase.site"

Delete a site​

  1. Open the Sites page in the console.
  2. Select the Site, then select Delete from the menubar at the bottom.

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​