Docs
Il Delta del Po
Deploy Site

Deploy Site

Hugo generates static websites, allowing for flexible hosting options. This page provides guides for deploying your Hextra site on various platforms.

GitHub Pages

GitHub Pages is the recommended way to deploy and host your website for free.

If you bootstrap the site using hextra-starter-template, it has provided GitHub Actions workflow out-of-the-box that helps automatically deploy to GitHub Pages.

In your repository settings, set the Pages > Build and deployment > Source to GitHub Actions:

By default, the above GitHub Actions workflow .github/workflows/pages.yaml assumes that the site is deploying to https://<USERNAME>.github.io/<REPO>/.

If you are deploying to https://<USERNAME>.github.io/ then modify the --baseURL:

.github/workflows/pages.yaml
54
55
56
57

run: |
  hugo \
    --gc --minify \
    --baseURL "https://${{ github.repository_owner }}.github.io/"

If you are deploying to your own domain, please change the --baseURL value accordingly.

Cloudflare Pages

  1. Put your site source code in a Git repository (e.g. GitHub)
  2. Log in to the Cloudflare dashboard and select your account
  3. In Account Home, select Workers & Pages > Create application > Pages > Connect to Git
  4. Select the repository, and in the Set up builds and deployments section, provide the following information:
Configuration Value
Production branch main
Build command hugo --gc --minify
Build directory public

For more details, check out:

Netlify

  1. Push your code to your Git repository (GitHub, GitLab, etc.)
  2. Import the project to Netlify
  3. If you are not using [hextra-starter-template][hextra-starter-template], configure the following manually:
    • Configure the Build command to hugo --gc --minify
    • Specify the Publish directory to public
    • Add Environment variable HUGO_VERSION and set to 0.132.2
  4. Deploy!

Check Hugo on Netlify for more details.

Vercel

  1. Push your code to your Git repository (GitHub, GitLab, etc.)
  2. Go to Vercel Dashboard and import your Hugo project
  3. Configure the project, select Hugo as Framework Preset
  4. Override the Build Command and Install command:
    1. Set Build Command to hugo --gc --minify
    2. Set Install Command to yum install golang

Vercel Deployment Configuration

Diagrams