publysher / docker-hugo

Docker base image for static sites generated with Hugo

publysher/hugo

publysher/hugo is a Docker base image for static sites generated with Hugo.

Images derived from this image can either run as a stand-alone server, or function as a volume image for your web server.

Prerequisites

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:

FROM publysher/hugo 

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

Examples

For an example of a Hugo site, have a look at https://github.com/publysher/blog.publysher.nl

docker-hugo's Issues

No asciidoc installed

Hugo sites that use asciidoc dont get rendered as the container doesnt seem to have asciidoc

Current Hugo Version 0.26

Version is outdated. Current version of Hugo is now 0.26.

Can you create multiple versions of this docker, or update to 0.26? Thanks for the docker image.

Server Bind instruction is required when using boot2docker on a Mac

Hello,

Thank you for the contribution. It was an inspiration source for my own implementation.

It would be worthwhile to add a warning to the README on how to run the containerized Hugo server on some configuration, It took me some frustrating hours to find out.

When using boot2docker (or Docker-machine with the VirtualBox provider) on a Mac OSX, the Hugo server must be started with the --bind=0.0.0.0 option as the interface bound by default (127.0.0.1) is not visible outside the virtual environement

I suggest to update the README with that information as you already give the advise for the IP address.

Enhancement request: support for tags on docker hub

Request:
Can the images pushed to publysher/hugo be tagged with the hugo release?

Reason:
I use gitlab CI and the publysher/hugo container image to update my website after every push. Sometimes my hugo is out of date locally, so my local test works fine, but then once pushed to gitlab the build fails because publysher/hugo has a more recent version of hugo. If the Docker hub images were tagged I would be able to manage this versioning much better.

Docker tag 0.20 using latest Hugo

The Docker image tagged as 0.20 is Hugo 0.22.1 instead of 0.20.

https://hub.docker.com/r/publysher/hugo/builds/bhakkznnyelrwrbqvkglyn4/