Hugo Docker

The world’s fastest framework for building websites

Docker

Normal build:

docker run --rm -it -v $(pwd):/src klakegg/hugo new site quickstart
cd quickstart
git init
git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke themes/ananke
echo "theme = 'ananke'" >> config.toml

Run server:

docker run --rm -it -v $(pwd):/src -p 1313:1313 klakegg/hugo server

http://localhost:1313/

Docker Compose

Normal build:

  build:
    image: klakegg/hugo:0.101.0
    volumes:
      - ".:/src"

Run server:

  server:
    image: klakegg/hugo:0.101.0
    command: server
    volumes:
      - ".:/src"
    ports:
      - "1313:1313"

Add content

docker run --rm -it -v $(pwd):/src klakegg/hugo new posts/my-first-post.md
vi posts/my-first-post.md

---
title: "My First Post"
date: 2022-11-20T09:03:20-08:00
draft: true
---
## Introduction

This is **bold** text, and this is *emphasized* text.

Visit the [Hugo](https://gohugo.io) website!

docker run --rm -it -v $(pwd):/src -p 1313:1313 klakegg/hugo server --buildDrafts

Basic usage

hugo version
hugo help
hugo server --help

Build your site

hugo

Draft, future, and expired content

hugo --buildDrafts    # or -D
hugo --buildExpired   # or -E
hugo --buildFuture    # or -F

Hugo shell

docker run --rm -it \
  -v $(pwd):/src \
  klakegg/hugo:0.101.0-alpine \
  shell

Using Pandoc

docker run --rm -it \
  -v $(pwd):/src \
  -e HUGO_PANDOC="pandoc-default --strip-empty-paragraphs" \
  klakegg/hugo:0.101.0-pandoc

Screenshots

References

• Hugo

• Hugo GitHub

• Hugo Docker

• Quick Start

• Basic usage