Skip to content
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Go to file
Cannot retrieve contributors at this time

Deploying to 21YunBox

21YunBox provides blazing fast Chinese CDN, continuous deployment, one-click HTTPS and other services like managed databases and backend web services, providing an avenue to launch web projects in China.

21YunBox includes the following features:

  • Continuous, automatic builds & deploys from GitHub and Gitee
  • Automatic SSL certificates through Let's Encrypt
  • Instant cache invalidation with a blazing fast, Chinese CDN
  • Unlimited custom domains
  • Automatic Brotli compression for faster sites
  • Native HTTP/2 support
  • Automatic HTTP → HTTPS redirects
  • Custom URL redirects and rewrites


This guide assumes you already have a Gatsby project to deploy. If you need a project, use the quick Start to get started or fork 21YunBox's Gatsby Example before continuing.


You can set up a Gatsby site on 21YunBox in two quick steps:

  1. Create a new web service on 21YunBox, and give 21YunBox permission to access your GitHub or Gitee repo.

  2. Use the following values during creation:

    Environment Static Site
    Build Command yarn && yarn build (or your own build command)
    Publish Directory ./public (or your own output directory)

That's it! Your site will be live on your 21YunBox URL (which looks like as soon as the build is done.

Continuous deploys

Now that 21YunBox is connected to your repo, it will automatically build and publish your site any time you push to GitHub.

21YunBox CDN and cache invalidation

21YunBox hosts your site on a Chinese, blazing fast CDN which ensures the fastest possible download times for all your users across China.

Every deploy automatically and instantly invalidates the CDN cache, so your users can always access the latest content on your site.

Custom domains

Add your own domains to your site easily using 21YunBox's custom domains guide.