Docker Jekyll with Chirpy

Build your own Jekyll with theme Chirpy in Docker

Setting up your own Jekyll blog using the Chirpy theme doesn’t have to be complicated. Whether you want to test it locally, develop on a containerized environment, or deploy your blog using Docker, this guide walks you through every step.

In this post, we’ll cover:

• 🛠️ How to containerize a Jekyll project using Docker.
• 🎨 How to integrate the Chirpy theme.

Warning:

• 👉 You will need your own private Jekyll repo.
  • 💡 Use this Template: Template
  • 💡 Use a ${GITHUB_TOKEN} to build it.
  • ⚠️ Make your Docker Library private if you plan to upload to DockerHub.

This setup is perfect if:

• You want to avoid installing Ruby and all dependencies on your host.
• You like isolated and reproducible environments.
• Build for Production mode

Let’s get your blog running in a container in just a few minutes.

---

🐳 1 - Build Jekyll + Chirpy theme

FROM ubuntu:22.04
ENV DEBIAN_FRONTEND=noninteractive

ARG GITHUB_TOKEN

# Update and Install
RUN apt-get update && \
    apt-get install -y \
    curl \
    git \
    build-essential \
    libssl-dev \
    libreadline-dev \
    zlib1g-dev \
    libsqlite3-dev \
    libyaml-dev \
    libcurl4-openssl-dev \
    libffi-dev \
    libgdbm6 \
    libgdbm-dev \
    gcc \
    make \
    autoconf \
    bzip2 \
    libbz2-dev \
    unzip \
    gnupg2 \
    nginx && \
    apt-get clean

# Install Node.js 18
RUN curl -fsSL https://deb.nodesource.com/setup_18.x | bash - && \
    apt-get install -y nodejs    

# Install rbenv and ruby-build
RUN curl -fsSL https://github.com/rbenv/rbenv-installer/raw/main/bin/rbenv-installer | bash

# Configure rbenv
ENV PATH /root/.rbenv/bin:$PATH
RUN eval "$(rbenv init -)" && \
    rbenv install 3.1.2 && \
    rbenv global 3.1.2

# Install Jekyll and Bundler
RUN /bin/bash -c "export PATH=/root/.rbenv/bin:/root/.rbenv/shims:$PATH && eval \"\$(rbenv init -)\" && gem install jekyll bundler && rbenv rehash"

# Clone your Repository
RUN git clone https://${GITHUB_TOKEN}:x-oauth-basic@github.com/youruser/jekyll.git /root/jekyll-chirpy

EXPOSE 80
WORKDIR /root/jekyll-chirpy

# Install Ruby and Node.js (bundle + npm + build)
RUN /bin/bash -c "export PATH=/root/.rbenv/bin:/root/.rbenv/shims:$PATH && \
  eval \"\$(rbenv init -)\" && \
  gem install sass-embedded -v 1.86.0 && \
  bundle install && \
  npm install && \
  npm run build"


RUN rm -rf /var/www/html && mkdir -p /var/www/html

# NGINX simple
RUN echo 'server { \
    listen 80; \
    root /var/www/html; \
    index index.html; \
    location / { \
        try_files $uri $uri/ =404; \
    } \
}' > /etc/nginx/sites-enabled/default

# CMD for Prod (pull + build + serve)
CMD ["/bin/bash", "-c", "\
  cd /root/jekyll-chirpy && \
  git pull origin master && \
  export PATH=/root/.rbenv/bin:/root/.rbenv/shims:$PATH && \
  /root/.rbenv/shims/bundle install && \
  JEKYLL_ENV=production /root/.rbenv/shims/bundle exec jekyll build && \
  rm -rf /var/www/html/* && \
  cp -r _site/* /var/www/html && \
  nginx -g 'daemon off;'"]

• 🙌 Your are done!! This Docker will download your jekyll repo and serve it.
• 👉 When you modify your repo, you only need to restart your docker!