Alpine Base Docker Image for Hugo (Hugo extended and Hugo Modules)

• peaceiris/hugo - Docker Hub

Getting started

Image tag	Base Image	Image size	Notes
peaceiris/hugo:v0.x.x	alpine:3.13	74MB	Small image
peaceiris/hugo:v0.x.x-mod	golang:1.15-alpine3.13	367MB	Hugo Modules feature is available
peaceiris/hugo:v0.x.x-full	golang:1.15-alpine3.13	420MB	Hugo Modules and Node.js are available

The image size is a result of the docker images command.

• Hugo Modules: hugo mod
• Hugo Modules and Node.js: hugo mod, node and npm

ghcr.io/peaceiris/hugo is also available.

(1) Docker Compose

Create your docker-compose.yml like the following.

version: '3'

services:
  hugo:
    container_name: hugo
    image: peaceiris/hugo:v0.x.x
    # image: peaceiris/hugo:v0.x.x-mod   # Hugo Modules
    # image: peaceiris/hugo:v0.x.x-full  # Hugo Modules and Node.js
    ports:
      - 1313:1313
    volumes:
      - ${PWD}:/src
    command:
      - server
      - --bind=0.0.0.0
      - --buildDrafts

(2) Usage

# Run "hugo server"
docker-compose up

# Build site
docker-compose run --rm hugo ""
# Build site with flags
docker-compose run --rm hugo --gc --minify --cleanDestinationDir

# Run a command of Hugo
docker-compose run --rm hugo env

GitHub Actions for Hugo

The Hugo Setup GitHub Action is recommended.

• peaceiris/actions-hugo: GitHub Actions for Hugo ⚡️ Setup Hugo quickly and build your site fast. Hugo extended, Hugo Modules, Linux (Ubuntu), macOS, and Windows are supported.

License

• MIT License - peaceiris/hugo-extended-docker

Maintainer

• peaceiris homepage