How to Deploy a Docusaurus Site with Vercel

This guide will show you how to deploy a Docusaurus site and get your domain set up.

Docusaurus is a documentation framework that enables you to maintain open-source documentation websites. This guide covers how to deploy a Docusaurus v2 site. To build an Docusaurus site, start with a template:

• Docusaurus

Copy link to headingDeploy Docusaurus to Vercel

Vercel is a platform for deploying the fastest Docusaurus sites. You can deploy your site with zero configuration to the best frontend infrastructure.

• Develop: Build Docusaurus sites that connect to your favorite APIs, databases, and content management systems.
• Preview: Integrate with any GitHub, GitLab, or Bitbucket repository for instant continuous deployment.
• Ship: Deploy your site to every edge node worldwide for the fastest Docusaurus sites. Static files, Vercel Functions, the CDN, and more.

Copy link to headingBuilt-in CI/CD for Docusaurus sites

Vercel has integrations for GitHub, GitLab, and Bitbucket to enable CI/CD for your Docusaurus site with zero configuration. Then, you can run automated tests for performance and reliability on every push. Pull and merge requests are deployed instantly to a unique URL, accessible to your entire team.

Copy link to headingAdd your custom domain

After deploying, your new Docusaurus site will get automatically assigned a .vercel.app suffixed domain. You can then add a Custom Domain on your choice, either from a third-party or purchased through Vercel.

Copy link to headingDeploy Docusaurus to Vercel

Copy link to headingStart from a template

• Docusaurus

Copy link to headingVercel CLI

1. Install the Vercel CLI and run vercel to deploy.
2. Vercel will detect that you are using Docusaurus and will enable the correct settings for your deployment.
3. Your site is deployed! (e.g. docusaurus-2-template.vercel.app)

Copy link to headingVercel for Git

1. Push your code to your git repository (GitHub, GitLab, BitBucket).
2. Import your Docusaurus project into Vercel.
3. Vercel will detect that you are using Docusaurus and will enable the correct settings for your deployment.
4. Your site is deployed! (e.g. docusaurus-2-template.vercel.app)