hugo/docs/content/en/host-and-deploy/host-on-netlify/index.md

title, description, categories, keywords, aliases

title	description	categories	keywords	aliases
Host on Netlify	Host your project on Netlify.			/hosting-and-deployment/hosting-on-netlify/

Use these instructions to enable continuous deployment from a GitHub repository. The same general steps apply for other Git providers such as GitLab or Bitbucket.

{{% include "/_common/gitignore-public.md" %}}

Prerequisites

Please complete the following tasks before continuing:

1. Create a Netlify account.
2. Log in to your Netlify account.
3. Create a GitHub account.
4. Log in to your GitHub account.
5. Create a GitHub repository for your project.
6. Create a local Git repository for your project with a remote reference to your GitHub repository.
7. Create a Hugo project within your local Git repository and test it with the hugo server command.
8. Commit the changes to your local Git repository and push to your GitHub repository.

Procedure

Step 1

Create a netlify.toml file in the root of your project, adjusting the tool versions and time zone as needed.

[build.environment]
GO_VERSION = "1.26.4"
HUGO_VERSION = "0.163.3"
NODE_VERSION = "24.16.0"
TZ = "Europe/Oslo"

[build]
publish = "public"
command = """\
  git config --global core.quotepath false && \
  hugo build --gc --minify --baseURL "${URL}"
  """

If your project requires Dart Sass to transpile Sass to CSS, set the DART_SASS_VERSION and include the Dart Sass installation in the build step.

[build.environment]
DART_SASS_VERSION = "1.101.0"
GO_VERSION = "1.26.4"
HUGO_VERSION = "0.163.3"
NODE_VERSION = "24.16.0"
TZ = "Europe/Oslo"

[build]
publish = "public"
command = """\
  curl -sfLO "https://github.com/sass/dart-sass/releases/download/${DART_SASS_VERSION}/dart-sass-${DART_SASS_VERSION}-linux-x64.tar.gz" && \
  tar -C "${HOME}/.local" -xf "dart-sass-${DART_SASS_VERSION}-linux-x64.tar.gz" && \
  rm "dart-sass-${DART_SASS_VERSION}-linux-x64.tar.gz" && \
  export PATH="${HOME}/.local/dart-sass:${PATH}" && \
  git config --global core.quotepath false && \
  hugo build --gc --minify --baseURL "${URL}"
  """

Step 2

In your project configuration, change the location of the image cache to the cacheDir as shown below:

{{< code-toggle file=hugo copy=true >}} [caches.images] dir = ':cacheDir/images' {{< /code-toggle >}}

See configure file caches for more information.

Step 3

Commit the changes to your local Git repository and push to your GitHub repository.

Step 4

In the upper right corner of the Netlify dashboard, press the Add new project button and select “Import an existing project".

Step 5

Connect to GitHub.

Step 6

Press the "Authorize Netlify" button to allow the Netlify application to access your GitHub account.

Step 7

Press the Configure Netlify on GitHub button.

Step 8

Select the GitHub account where you want to install the Netlify application.

Step 9

Authorize the Netlify application to access all repositories or only select repositories, then press the Install button.

Your browser will be redirected to the Netlify dashboard.

Step 10

Click on the name of the repository you wish to import.

Step 11

On the "Review configuration" page, enter a project name, leave the settings at their default values, then press the Deploy button.

Step 12

When the deployment completes, click on the link to your published site.

In the future, whenever you push a change from your local Git repository, Netlify will rebuild and deploy your site.