An Alpine based lightweight container for local GitHub Pages development
Tags are congruent with the versions of the GitHub Pages gem. "latest" should reflect the latest build with the latest gem version.
Pull the latest version using:
docker pull davidforster/github-pages
Or pull a specific version using (replacing nn with the desired version):
docker pull davidforster/github-pages:nn
Run the container using:
docker run -p 4000:4000 davidforster/github-pages
If you don't mount your source files as a volume then a default index.html page is configured which will allow you to test that the container is working (see index.html).
Based on the above, the following should work when added to your docker-compose.yml configuration file:
image: davidforster/github-pages
ports:
- 4000:4000
volumes:
- .:/home/jekyll/src
Volumes are defined for the source and served directories. Mount your source files at:
/home/jekyll/src
and collect your generated files from
/srv
Port 4000 (Jekyll's default WeBrick server port when running in "serve" mode) is exposed
The Jekyll process runs under the user "jekyll", created as part of the Docker build.
This project is licensed under the MIT License