Hugo Buildpack on App Platform

App Platform is a Platform-as-a-Service (PaaS) offering that allows developers to publish code directly to DigitalOcean servers without worrying about the underlying infrastructure.

How App Platform Builds Images

App Platform supports two ways to build an image for your app: Cloud Native Buildpacks and Dockerfiles.

When you give App Platform access to your code, it defaults to using a Dockerfile if one is present in the root of the directory or specified in the app spec. Otherwise, App Platform checks your code to determine what language or framework it uses. If it supports the language or framework, it chooses an appropriate resource type and uses the proper buildpack to build the app and deploy a container.

Hugo Applications using Buildpacks

App Platform looks for any of the following to detect a Hugo application:

  • config.toml
  • config.yaml
  • config.json

If App Platform detects one of these files, it guides you the remaining configuration and then builds the app with the appropriate buildpack.

Current Buildpack Version and Supported Runtimes

App Platform uses version v1.7.0 of the Hugo Cloud Native Buildpack. If no version is specified, App Platform defaults to using version 0.121.2.

The buildpack supports the following Hugo runtime versions:

  • Ubuntu-22
    • 0.54.0 - 0.121.2
  • Ubuntu-18
    • 0.54.0 - 0.121.2

Specify a Hugo Version

You can choose the default Hugo version by setting HUGO_VERSION environment variable to any valid release from Hugo’s upstream repository, like 0.82.0.

To use the extended version of Hugo with Sass/SCSS support, set the HUGO_EXTENDED environment variable to 1.