How to Deploy a Jekyll Site with Vercel

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

Jekyll is a blog-aware, static site generator perfect for personal, project, or organization sites. To build an Jekyll site, start with a template:

Deploy Jekyll to Vercel

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

  • Develop: Build Jekyll 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 Jekyll sites. Static files, Serverless and Edge Functions, and more.

Built-in CI/CD for Jekyll sites

Vercel has integrations for GitHubGitLab, and Bitbucket to enable CI/CD for your Jekyll 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.

Add your custom domain

After deploying, your new Jekyll 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.

Deploy Jekyll to Vercel

Start from a template

Vercel CLI

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

Vercel for Git

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

Caveats

Please note that recent Bundler versions (2.2.3+) started changing the way of deciding the installing platform (more details in this GitHub issue). Therefore, please run the following command locally in your project repository once, and commit the resulting Gemfile.lock file to be able to deploy your project on Vercel:

bundle lock --add-platform x86_64-linux

This is important especially if you're developing your app on different platforms (e.g., macOS, Windows, etc) as Vercel's build environment uses Linux.

Couldn't find the guide you need?