Developing With Docker Compose

Firstly, you’ll need to choose the proper image tag for your themes and sites, in this section, we take hugomods/hugo:exts-non-root as the example.

Create Docker Compose File

And then create docker-compose.yml on your project root.

 1name: mysite
 2
 3services:
 4  server:
 5    image: hugomods/hugo:exts-non-root
 6    command: server -D
 7    volumes:
 8      - ./:/src
 9      - ~/hugo_cache:/tmp/hugo_cache
10    ports:
11      - 1313:1313

1. -v ./:/src mounts current working directory on the default working directory(/src) inside the Docker container.
2. -v ~/hugo_cache:/tmp/hugo_cache mounts $HOME/hugo_cache on the default cacheDir (/tmp/hugo_cache) to improve build performance.

Install Dependencies (Optional)

You may want to install the dependencies before running Hugo server, such as install dependencies via npm.

1docker compose run server npm i

1. npm i replaces the default command of server service, which is the shorthand of npm install.

Start Hugo Server

1docker compose up server

Launch Interactive Shell

1docker compose run server /bin/sh