Hugo Buildpack on App Platform
Validated on 24 Feb 2025 • Last edited on 6 Mar 2025
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.8.0
of the Hugo Cloud Native Buildpack. If no version is specified, App Platform defaults to using version 0.144.2
.
The buildpack supports the following Hugo runtime versions:
- Ubuntu-22
- 0.54.0 - 0.144.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.144.2
.
To use the extended version of Hugo with Sass/SCSS support, set the HUGO_EXTENDED
environment variable to 1
.