Images derived from this image can either run as a stand-alone server, or function as a volume image for your web server.
The image is based on the following directory structure:
. ├── Dockerfile └── site ├── config.toml ├── content │ └── ... ├── layouts │ └── ... └── static └── ...
In other words, your Hugo site resides in the
site directory, and you have a simple Dockerfile:
Building your site
Based on this structure, you can easily build an image for your site:
docker build -t my/image .
Your site is automatically generated during this build.
Using your site
There are two options for using the image you generated:
- as a stand-alone image
- as a volume image for your webserver
Using your image as a stand-alone image is the easiest:
docker run -p 1313:1313 my/image
This will automatically start
hugo server, and your blog is now available on http://localhost:1313.
If you are using
boot2docker, you need to adjust the base URL:
docker run -p 1313:1313 -e HUGO_BASE_URL=http://YOUR_DOCKER_IP:1313 my/image
The image is also suitable for use as a volume image for a web server, such as nginx
docker run -d -v /usr/share/nginx/html --name site-data my/image docker run -d --volumes-from site-data --name site-server -p 80:80 nginx
For an example of a Hugo site, have a look at https://github.com/publysher/blog.publysher.nl