Tutorial: Host a Docusaurus Site on Filebase

Tutorial: Host a Docusaurus Site on Filebase

Build your Docusaurus site locally, upload the contents of build/ to a bucket, and create a Filebase Site from that static output.

AuthorFilebase Team
CategoryTutorials

Build the Docusaurus Output

Docusaurus already builds to static HTML, CSS, and JS, which makes it a natural fit for Filebase. The deployable output lives in build/.

Build the Project

From your project root:

Terminal
npm run build

Docusaurus writes the static site to build/. Depending on your configuration, you may also see folders that reflect your baseUrl structure.

Upload the Contents of build/

In Filebase, create a bucket and upload the contents of build/. The bucket root should contain index.html and the rest of the generated site directly.

Do not upload the build folder itself. The built files need to sit at the top level of the bucket.

Keep only the built site files in that bucket. After the upload, copy the bucket CID from the bucket storing those files. You will use that bucket CID when you create the site.

Create the Site

Open Sites in the dashboard and create a new site, then paste in the bucket CID you copied from the bucket storing the site files. Filebase will use that CID as the site’s content source.

Other Frameworks

We also have framework-specific guides for Vite, Next.js, Remix, Gatsby, and Astro.