Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/peaceiris/hugo-extended-docker

Debian Based Docker Images for Hugo (Hugo extended and Hugo Modules)
https://github.com/peaceiris/hugo-extended-docker

docker docker-image gohugo gohugoio hugo

Last synced: 4 days ago
JSON representation

Debian Based Docker Images for Hugo (Hugo extended and Hugo Modules)

Host: GitHub
URL: https://github.com/peaceiris/hugo-extended-docker
Owner: peaceiris
License: mit
Created: 2020-01-30T21:46:27.000Z (almost 5 years ago)
Default Branch: main
Last Pushed: 2024-12-30T18:50:59.000Z (27 days ago)
Last Synced: 2025-01-16T07:12:31.398Z (11 days ago)
Topics: docker, docker-image, gohugo, gohugoio, hugo
Language: Makefile
Homepage: https://hub.docker.com/r/peaceiris/hugo
Size: 533 KB
Stars: 61
Watchers: 2
Forks: 9
Open Issues: 5
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        
[![license](https://img.shields.io/github/license/peaceiris/hugo-extended-docker.svg)](https://github.com/peaceiris/hugo-extended-docker/blob/main/LICENSE)

![CI](https://github.com/peaceiris/hugo-extended-docker/workflows/CI/badge.svg?branch=main&event=push)



## Debian Based Docker Image for Hugo (Hugo extended and Hugo Modules)

- [peaceiris/hugo - Docker Hub]

[![DockerHub Badge](https://dockeri.co/image/peaceiris/hugo)][peaceiris/hugo - Docker Hub]

[peaceiris/hugo - Docker Hub]: https://hub.docker.com/r/peaceiris/hugo

Docker images on GitHub Packages [ghcr.io/peaceiris/hugo] are also available.

[ghcr.io/peaceiris/hugo]: https://github.com/users/peaceiris/packages/container/package/hugo

## Getting Started

### (1) Select Your Image

| Image Name | Base Image | COMPRESSED SIZE | Notes |

|---|---|---:|---|

| `peaceiris/hugo:v0.x.x` | `debian:bullseye-slim` | 72.64 MB | Slim image |

| `peaceiris/hugo:v0.x.x-mod` | `golang:1.20-bullseye` | 315.19 MB | Hugo Modules feature is available |

| `peaceiris/hugo:v0.x.x-full` | `golang:1.20-bullseye` | 378.96 MB | Hugo Modules and Node.js are available |

> **Note**

>

> - `peaceiris/hugo = ghcr.io/peaceiris/hugo`

> - Hugo Modules: `hugo mod`

> - Node.js: `node` and `npm`

### (2) Create Your docker-compose.yml

Create your `docker-compose.yml` like the following.

```yaml

version: '3'

services:

  hugo:

    container_name: hugo

    image: peaceiris/hugo:v0.x.x            # Minimum image

    # image: peaceiris/hugo:v0.x.x-mod      # Hugo Modules

    # image: peaceiris/hugo:v0.x.x-full     # Hugo Modules and Node.js

    # image: ghcr.io/peaceiris/hugo:v0.x.x  # Docker images on GitHub Packages

    ports:

      - 1313:1313

    volumes:

      - ${PWD}:/src

    command:

      - server

      - --bind=0.0.0.0

      - --buildDrafts

```

### (3) Start Your Container

```sh

# Run "hugo server"

docker-compose up

# Build site

docker-compose run --rm hugo ""

# Build site with flags

docker-compose run --rm hugo --gc --minify --cleanDestinationDir

# Run a command of Hugo

docker-compose run --rm hugo env

```

## GitHub Actions for Hugo

The Hugo Setup GitHub Action is recommended.

- [peaceiris/actions-hugo: GitHub Actions for Hugo ⚡️ Setup Hugo quickly and build your site fast. Hugo extended, Hugo Modules, Linux (Ubuntu), macOS, and Windows are supported.](https://github.com/peaceiris/actions-hugo)

## License

- [MIT License - peaceiris/hugo-extended-docker]

[MIT License - peaceiris/hugo-extended-docker]: https://github.com/peaceiris/hugo-extended-docker/blob/main/LICENSE

## Maintainer

- [peaceiris homepage](https://peaceiris.com/)