Hugo + GitHub Actions: a simple deployment pipeline

Tue, 16 Dec 2025 00:00:00 +0000

Introduction

The simplest way to automatically deploy a Hugo site is this: keep the whole project in a GitHub repository, and let GitHub Actions build the site on every push and upload the generated public/ directory to your server over SSH using rsync.

Assumptions

Here I assume two things.

First, you already have a working Hugo project locally. For example, you created it with hugo new site your_site and you checked that running the hugo command locally correctly generates the public/ directory.

Pipeline on Kliku Kliku

Hugo + GitHub Actions: a simple deployment pipeline

Introduction

Assumptions