{"id":13718722,"url":"https://github.com/hubci/hugo-docker","last_synced_at":"2026-01-16T15:39:07.916Z","repository":{"id":37471435,"uuid":"85594334","full_name":"hubci/hugo-docker","owner":"hubci","description":"A Docker image for Hugo, the static-site generator. This image focuses on a CI use-case, not production. Includes HTMLProofer for testing.","archived":false,"fork":false,"pushed_at":"2026-01-02T20:41:06.000Z","size":396,"stargazers_count":64,"open_issues_count":3,"forks_count":10,"subscribers_count":4,"default_branch":"trunk","last_synced_at":"2026-01-05T19:34:05.133Z","etag":null,"topics":["circleci","docker","html-proofer","hubci","hugo","static-site-generator"],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/hubci/hugo/","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hubci.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2017-03-20T15:33:49.000Z","updated_at":"2026-01-02T20:41:08.000Z","dependencies_parsed_at":"2023-02-10T11:15:19.704Z","dependency_job_id":"175bf1c1-6752-4f96-af21-91e5830af3c3","html_url":"https://github.com/hubci/hugo-docker","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/hubci/hugo-docker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hubci%2Fhugo-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hubci%2Fhugo-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hubci%2Fhugo-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hubci%2Fhugo-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hubci","download_url":"https://codeload.github.com/hubci/hugo-docker/tar.gz/refs/heads/trunk","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hubci%2Fhugo-docker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28479409,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T11:59:17.896Z","status":"ssl_error","status_checked_at":"2026-01-16T11:55:55.838Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["circleci","docker","html-proofer","hubci","hugo","static-site-generator"],"created_at":"2024-08-03T01:00:36.486Z","updated_at":"2026-01-16T15:39:07.890Z","avatar_url":"https://github.com/hubci.png","language":"Dockerfile","funding_links":[],"categories":["Starters"],"sub_categories":["Non-Official"],"readme":"# HubCI: Hugo [![Build Status](https://circleci.com/gh/hubci/hugo-docker.svg?style=shield)](https://circleci.com/gh/hubci/hugo) [![Docker Repository](https://img.shields.io/badge/Docker%20Repository-Docker%20Hub-blue.svg)](https://hub.docker.com/r/hubci/hugo/) [![Software License](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/hubci/hugo/trunk/LICENSE)\n\nA Docker image for [Hugo](http://gohugo.io/), a static-site generator. Includes [HTMLProofer](https://github.com/gjtorikian/html-proofer) for testing. Hosted on [Docker Hub](https://hub.docker.com/r/hubci/hugo/).\n\nCurrently, this Docker image is designed to be used as a base image on CircleCI for building, testing, and deploying Hugo based websites.\n\nI plan to make this image useful for local testing and build/test/deploy on other CI provider as well in the future.\n\n\n## Using on CircleCI\n\nUsing this image to build your Hugo generated website on CircleCI can be as simple as using the following configuration in `.circleci/config.yml`:\n\n```yaml\nversion: 2.1\njobs:\n  build:\n    docker:\n      - image: hubci/hugo:0.96.0\n    steps:\n      - checkout\n      - run:\n          name: \"Run Hugo\"\n          command: HUGO_ENV=production hugo -v -s src/\n      - run:\n          name: \"Test Website\"\n          command: htmlproofer src/public --allow-hash-href --check-html --empty-alt-ignore --disable-external\n```\n\n### Version\n\n`0.96.0` is the version of Hugo to use.\nYou can use a complete SemVer version number such as `0.96.0` to specifically pin to that release.\nYou can also use `0.96` which will use Hugo `0.96.0`, and then `0.96.1`, and `0.96.2`, and so on as newer versions are released.\n\nYou can also use `nightly` to use the in-development version.\n`nightly` is a snapshot of whatever is in the `master` branch of Hugo, which is unreleased, updated at least once a day.\n\n`edge` - the edge tag is available as a testing ground for new changes to this image.\nChanges to `trunk` will appear immediately in the `hugo:edge` image.\nThe next proper release will also include those changes unless they are removed before hand.\n\nIn this example, we assume the Hugo files are in a directory called `src` in the repo. A full walkthrough on how to do this can be found on [CircleCI's blog](https://circleci.com/blog/build-test-deploy-hugo-sites/).\n\n\n## Building The Images\n\nTo prepare new images, I run `./shared/gen-dockerfiles.sh` locally, passing it the current Hugo versions that I am \"supporting\". For example, for the initial release, I ran `./shared/gen-dockerfiles.sh 0.96.0`.\n\nThat creates the Dockerfiles and the build script for them.\nFor actual, proper releases though, I run the `./shared/release.sh` script.\nThis script runs `gen-dockerfiles.sh` but also does all the Git work to publish a proper release.\nThe flag `[release]` is added to the commit message to initiate a release.\n\n\n## Websites Using This \u0026 Examples\n\nThe following sites use Hugo and this image (and some have their config public):\n\n- \u003chttps://www.Feliciano.Tech\u003e ([repository](https://github.com/felicianotech/www.feliciano.tech))\n- \u003chttps://HugoNewsletter.com\u003e ([repository](https://github.com/felicianotech/hugonewsletter.com))\n- \u003chttps://DocsThursday.com\u003e ([repository](https://github.com/felicianotech/docsthursday.com))\n- \u003chttps://www.DiscourseHub.com\u003e ([repository](https://github.com/discoursehub/www.discoursehub.com))\n- [UNICEF Open Source Inventory](https://unicef.github.io/inventory/) ([repository](https://github.com/unicef/inventory))\n- [UNICEF Drones for SDGs Toolkit](https://unicef.github.io/drone-4sdgtoolkit/) ([repository](https://github.com/unicef/drone-4sdgtoolkit))\n\n\n## Feedback \u0026 Contributing\n\nPlease feel free to open GitHub Issues for any questions, bugs, request, etc. You can also write a new post on [Hugo's forum](https://discuss.gohugo.io/) and ping me, `FelicianoTech`. Pull Request welcome as well.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhubci%2Fhugo-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhubci%2Fhugo-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhubci%2Fhugo-docker/lists"}