Netlify

Deploy to Netlify with sensible defaults. Easily use Netlify Functions, Netlify Redirects, and Netlify Headers.

On this page

  1. .
  2. ├── assets/
  3. │   └── lambda/
  4. ├── layouts/
  5. │   ├── index.headers
  6. │   └── index.redirects
  7. └── netlify.toml

See also the Hugo Docs: Host on Netlify.

Functions

Functions in ./assets/lambda/ are compiled on build to ./functions/.

See also the Netlify docs: Functions overview

Redirects

./layouts/index.redirects is converted on build to ./public/_redirects.

  1. {{ range $pages := .Site.Pages -}}
  2.   {{ range .Aliases -}}
  3.     {{ . }} {{ $pages.RelPermalink -}}
  4.   {{ end -}}
  5. {{ end -}}

See also the Netlify docs: Redirects and rewrites

Headers

./layouts/index.headers is converted on build to ./public/_headers.

  1. /*
  2.   Strict-Transport-Security: max-age=31536000; includeSubDomains; preload
  3.   X-Content-Type-Options: nosniff
  4.   X-XSS-Protection: 1; mode=block
  5.   Content-Security-Policy: default-src 'none'; manifest-src 'self'; connect-src 'self'; font-src 'self'; img-src 'self'; script-src 'self'; style-src 'self'
  6.   X-Frame-Options: SAMEORIGIN
  7.   Referrer-Policy: strict-origin
  8.   Feature-Policy: geolocation 'self'
  9.   Cache-Control: public, max-age=31536000

See also the Netlify docs: Custom headers

Build and deploy

./netlify.toml:

  1. [build]
  2.   publish = "public"
  3.   functions = "functions"
  5. [build.environment]
  6.   NODE_VERSION = "15.5.1"
  7.   NPM_VERSION = "7.3.0"
  9. [context.production]
  10.   command = "npx hugo --gc --minify && npx netlify-lambda build assets/lambda"
  12. [context.deploy-preview]
  13.   command = "npx hugo --gc --minify -b $DEPLOY_PRIME_URL"
  15. [context.branch-deploy]
  16.   command = "npx hugo --gc --minify -b $DEPLOY_PRIME_URL"
  18. [context.next]
  19.   command = "npx hugo --gc --minify && npx netlify-lambda build assets/lambda"
  21. [context.next.environment]
  22.   HUGO_ENV = "next"
  24. [[plugins]]
  25.   package = "netlify-plugin-submit-sitemap"
  27.  [plugins.inputs]
  28.     baseUrl = "https://getdoks.org"
  29.     sitemapPath = "/sitemap.xml"
  30.     providers = [
  31.       "google",
  32.       "bing",
  33.       "yandex"
  34.     ]
  36. [dev]
  37.   framework = "#custom"
  38.   command = "npx rimraf public resources functions && npx hugo server --bind=0.0.0.0 --disableFastRender"
  39.   targetPort = 1313
  40.   port = 8888
  41.   publish = "public"
  42.   autoLaunch = false

See also the Netlify docs: File-based configuration