Hugo

Hugo is a versatile static site generator for blogs and websites alike. Deploying your Hugo site on Runway is as easy as:

hugo new site my-site
cd my-site

Hugo doesn’t come with a theme or any content by default. Add a minimal theme and a first page, for example:

git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke
echo "theme = 'ananke'" >> hugo.toml
hugo new content posts/my-first-post.md

Create the app on Runway (this also initializes a git repository, if none exists yet), then commit everything:

runway app create
git add -A && git commit -m "initial commit"

Deploy to Runway

runway app deploy

Run runway app open to see it live, or check the Runway UI. Check runway app logs if something’s off.

Run these commands inside your repository and Runway will build and deploy your website (with Nginx).

Our Hugo buildpack includes Golang for hugo mod and serves your site with Nginx.

Optional configuration

To use a specific Hugo version, set the following:

[build]
  [[build.env]]
    name = "BP_RUNWAY_STATIC_HUGO_VERSION"
    value = "0.157.0"

Redeploy after changing this:

runway app deploy

To configure Nginx, add an nginx.conf file to the root of your repository with your server configuration. To see an example of what is needed, you can check out the web server config recipe.

Example

We also have an example for Hugo on GitHub, but no Runway-specific configuration is needed.