# How to Deploy a Docusaurus Site with Vercel

**Author:** Matthew Sweeney, Rich Haines

---

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

[Docusaurus](https://docusaurus.io/) 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](https://vercel.com/new/clone?s=https%3A%2F%2Fgithub.com%2Fvercel%2Fvercel%2Ftree%2Fmain%2Fexamples%2Fdocusaurus-2&template=docusaurus-2&id=67753070&b=main&from=templates)
  

## Deploy 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](https://vercel.com/features/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](https://vercel.com/features/previews).
  
- **Ship:** Deploy your site to every edge node worldwide for the fastest Docusaurus sites. Static files, Vercel Functions, the CDN, and [more](https://vercel.com/features/infrastructure).
  

## Built-in CI/CD for Docusaurus sites

Vercel has integrations for [GitHub](https://vercel.com/docs/deployments/git/vercel-for-github), [GitLab](https://vercel.com/docs/deployments/git/vercel-for-gitlab), and [Bitbucket](https://vercel.com/docs/deployments/git/vercel-for-bitbucket) to enable CI/CD for your Docusaurus site with zero configuration. Then, you can run [automated tests for performance and reliability](https://vercel.com/docs/concepts/deployments/checks) on every push. Pull and merge requests are deployed instantly to a unique URL, accessible to your entire team.

## Add 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](https://vercel.com/docs/concepts/projects/custom-domains) on your choice, either from a third-party or [purchased through Vercel](https://vercel.com/domains).

## Deploy Docusaurus to Vercel

### Start from a template

- [Docusaurus](https://vercel.com/new/clone?s=https%3A%2F%2Fgithub.com%2Fvercel%2Fvercel%2Ftree%2Fmain%2Fexamples%2Fdocusaurus-2&template=docusaurus-2&id=67753070&b=main&from=templates)
  

### Vercel CLI

1. Install the [Vercel CLI](https://vercel.com/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](https://docusaurus-2-template.vercel.app/))
   

### Vercel for Git

1. Push your code to your git repository (GitHub, GitLab, BitBucket).
   
2. [Import your Docusaurus project](https://vercel.com/new) 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](https://docusaurus-2-template.vercel.app/))

---

[View full KB sitemap](/kb/sitemap.md)