diff options
Diffstat (limited to 'docs/content/en/host-and-deploy/host-on-netlify')
13 files changed, 143 insertions, 0 deletions
diff --git a/docs/content/en/host-and-deploy/host-on-netlify/index.md b/docs/content/en/host-and-deploy/host-on-netlify/index.md new file mode 100644 index 000000000..f3601331a --- /dev/null +++ b/docs/content/en/host-and-deploy/host-on-netlify/index.md @@ -0,0 +1,143 @@ +--- +title: Host on Netlify +description: Host your site on Netlify. +categories: [] +keywords: [] +aliases: [/hosting-and-deployment/hosting-on-netlify/] +--- + +## Prerequisites + +Please complete the following tasks before continuing: + +1. [Create a Netlify account] +1. [Install Git] +1. [Create a Hugo site] and test it locally with `hugo server` +1. Commit the changes to your local repository +1. Push the local repository to your [GitHub], [GitLab], or [Bitbucket] account + +[Bitbucket]: https://bitbucket.org/product +[Create a Hugo site]: /getting-started/quick-start/ +[Create a Netlify account]: https://app.netlify.com/signup +[GitHub]: https://github.com +[GitLab]: https://about.gitlab.com/ +[Install Git]: https://git-scm.com/book/en/v2/Getting-Started-Installing-Git + +## Procedure + +This procedure will enable continuous deployment from a GitHub repository. The procedure is essentially the same if you are using GitLab or Bitbucket. + +### Step 1 + +Log in to your Netlify account, navigate to the Sites page, press the **Add new site** button, and choose "Import an existing project" from the dropdown menu. + +### Step 2 + +Select your deployment method. + +  + +### Step 3 + +Authorize Netlify to connect with your GitHub account by pressing the **Authorize Netlify** button. + + + +### Step 4 + +Press the **Configure Netlify on GitHub** button. + + + +### Step 5 + +Install the Netlify app by selecting your GitHub account. + + + +### Step 6 + +Press the **Install** button. + + + +### Step 7 + +Click on the site's repository from the list. + + + +### Step 8 + +Set the site name and branch from which to deploy. + + + +### Step 9 + +Define the build settings, press the **Add environment variables** button, then press the **New variable** button. + + + +### Step 10 + +Create a new environment variable named `HUGO_VERSION` and set the value to the [latest version]. + +[latest version]: https://github.com/gohugoio/hugo/releases/latest + + + +### Step 11 + +Press the "Deploy my new site" button at the bottom of the page. + + + +### Step 12 + +At the bottom of the screen, wait for the deploy to complete, then click on the deploy log entry. + + + +### Step 13 + +Press the **Open production deploy** button to view the live site. + + + +## Configuration file + +In the procedure above we configured our site using the Netlify user interface. Most site owners find it easier to use a configuration file checked into source control. + +Create a new file named netlify.toml in the root of your project directory. In its simplest form, the configuration file might look like this: + +```toml {file="netlify.toml"} +[build.environment] +HUGO_VERSION = "0.144.2" +NODE_VERSION = "22" +TZ = "America/Los_Angeles" + +[build] +publish = "public" +command = "hugo --gc --minify" +``` + +If your site requires Dart Sass to transpile Sass to CSS, the configuration file should look something like this: + +```toml {file="netlify.toml"} +[build.environment] +HUGO_VERSION = "0.144.2" +DART_SASS_VERSION = "1.85.0" +NODE_VERSION = "22" +TZ = "America/Los_Angeles" + +[build] +publish = "public" +command = """\ + curl -LJO https://github.com/sass/dart-sass/releases/download/${DART_SASS_VERSION}/dart-sass-${DART_SASS_VERSION}-linux-x64.tar.gz && \ + tar -xf dart-sass-${DART_SASS_VERSION}-linux-x64.tar.gz && \ + rm dart-sass-${DART_SASS_VERSION}-linux-x64.tar.gz && \ + export PATH=/opt/build/repo/dart-sass:$PATH && \ + hugo --gc --minify \ + """ +``` diff --git a/docs/content/en/host-and-deploy/host-on-netlify/netlify-step-02.png b/docs/content/en/host-and-deploy/host-on-netlify/netlify-step-02.png Binary files differnew file mode 100644 index 000000000..31fceff27 --- /dev/null +++ b/docs/content/en/host-and-deploy/host-on-netlify/netlify-step-02.png diff --git a/docs/content/en/host-and-deploy/host-on-netlify/netlify-step-03.png b/docs/content/en/host-and-deploy/host-on-netlify/netlify-step-03.png Binary files differnew file mode 100644 index 000000000..7b98e0b8f --- /dev/null +++ b/docs/content/en/host-and-deploy/host-on-netlify/netlify-step-03.png diff --git a/docs/content/en/host-and-deploy/host-on-netlify/netlify-step-04.png b/docs/content/en/host-and-deploy/host-on-netlify/netlify-step-04.png Binary files differnew file mode 100644 index 000000000..31304894b --- /dev/null +++ b/docs/content/en/host-and-deploy/host-on-netlify/netlify-step-04.png diff --git a/docs/content/en/host-and-deploy/host-on-netlify/netlify-step-05.png b/docs/content/en/host-and-deploy/host-on-netlify/netlify-step-05.png Binary files differnew file mode 100644 index 000000000..6d6eef01d --- /dev/null +++ b/docs/content/en/host-and-deploy/host-on-netlify/netlify-step-05.png diff --git a/docs/content/en/host-and-deploy/host-on-netlify/netlify-step-06.png b/docs/content/en/host-and-deploy/host-on-netlify/netlify-step-06.png Binary files differnew file mode 100644 index 000000000..1b766a785 --- /dev/null +++ b/docs/content/en/host-and-deploy/host-on-netlify/netlify-step-06.png diff --git a/docs/content/en/host-and-deploy/host-on-netlify/netlify-step-07.png b/docs/content/en/host-and-deploy/host-on-netlify/netlify-step-07.png Binary files differnew file mode 100644 index 000000000..7bb3b6eca --- /dev/null +++ b/docs/content/en/host-and-deploy/host-on-netlify/netlify-step-07.png diff --git a/docs/content/en/host-and-deploy/host-on-netlify/netlify-step-08.png b/docs/content/en/host-and-deploy/host-on-netlify/netlify-step-08.png Binary files differnew file mode 100644 index 000000000..df8e9e59f --- /dev/null +++ b/docs/content/en/host-and-deploy/host-on-netlify/netlify-step-08.png diff --git a/docs/content/en/host-and-deploy/host-on-netlify/netlify-step-09.png b/docs/content/en/host-and-deploy/host-on-netlify/netlify-step-09.png Binary files differnew file mode 100644 index 000000000..3f925accc --- /dev/null +++ b/docs/content/en/host-and-deploy/host-on-netlify/netlify-step-09.png diff --git a/docs/content/en/host-and-deploy/host-on-netlify/netlify-step-10.png b/docs/content/en/host-and-deploy/host-on-netlify/netlify-step-10.png Binary files differnew file mode 100644 index 000000000..e9196d0ce --- /dev/null +++ b/docs/content/en/host-and-deploy/host-on-netlify/netlify-step-10.png diff --git a/docs/content/en/host-and-deploy/host-on-netlify/netlify-step-11.png b/docs/content/en/host-and-deploy/host-on-netlify/netlify-step-11.png Binary files differnew file mode 100644 index 000000000..2ac2b08af --- /dev/null +++ b/docs/content/en/host-and-deploy/host-on-netlify/netlify-step-11.png diff --git a/docs/content/en/host-and-deploy/host-on-netlify/netlify-step-12.png b/docs/content/en/host-and-deploy/host-on-netlify/netlify-step-12.png Binary files differnew file mode 100644 index 000000000..e251305a4 --- /dev/null +++ b/docs/content/en/host-and-deploy/host-on-netlify/netlify-step-12.png diff --git a/docs/content/en/host-and-deploy/host-on-netlify/netlify-step-13.png b/docs/content/en/host-and-deploy/host-on-netlify/netlify-step-13.png Binary files differnew file mode 100644 index 000000000..f955f6369 --- /dev/null +++ b/docs/content/en/host-and-deploy/host-on-netlify/netlify-step-13.png |
