HUGO
News Docs Themes Community GitHub

Host on AWS Amplify

Host your site on AWS Amplify.

Use these instructions to enable continuous deployment from a GitHub repository. The same general steps apply if you are using GitLab for version control.

Prerequisites

Please complete the following tasks before continuing:

  1. Create an AWS account
  2. Log in to your AWS 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 site 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

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
Create a file named amplify.yml in the root of your project.
touch amplify.yml
Step 2
Copy and paste the YAML below into the file you created. Change the application versions and time zone as needed.
amplify.yml
version: 1
env:
  variables:
    # Application versions
    DART_SASS_VERSION: 1.91.0
    GO_VERSION: 1.25.0
    HUGO_VERSION: 0.149.0
    # Time zone
    TZ: Europe/Oslo
    # Cache
    HUGO_CACHEDIR: ${PWD}/.hugo
    NPM_CONFIG_CACHE: ${PWD}/.npm
frontend:
  phases:
    preBuild:
      commands:
        # Create directory for user-specific executable files
        - echo "Creating directory for user-specific executable files..."
        - mkdir -p "${HOME}/.local"

        # Install Dart Sass
        - echo "Installing Dart Sass ${DART_SASS_VERSION}..."
        - curl -sLJO "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}"

        # Install Go
        - echo "Installing Go ${GO_VERSION}..."
        - curl -sLJO "https://go.dev/dl/go${GO_VERSION}.linux-amd64.tar.gz"
        - tar -C "${HOME}/.local" -xf "go${GO_VERSION}.linux-amd64.tar.gz"
        - rm "go${GO_VERSION}.linux-amd64.tar.gz"
        - export PATH="${HOME}/.local/go/bin:${PATH}"

        # Install Hugo
        - echo "Installing Hugo ${HUGO_VERSION}..."
        - curl -sLJO "https://github.com/gohugoio/hugo/releases/download/v${HUGO_VERSION}/hugo_extended_${HUGO_VERSION}_linux-amd64.tar.gz"
        - mkdir "${HOME}/.local/hugo"
        - tar -C "${HOME}/.local/hugo" -xf "hugo_extended_${HUGO_VERSION}_linux-amd64.tar.gz"
        - rm "hugo_extended_${HUGO_VERSION}_linux-amd64.tar.gz"
        - export PATH="${HOME}/.local/hugo:${PATH}"

        # Verify installations
        - echo "Verifying installations..."
        - "echo Dart Sass: $(sass --version)"
        - "echo Go: $(go version)"
        - "echo Hugo: $(hugo version)"
        - "echo Node.js: $(node --version)"

        # Install Node.js dependencies
        - echo "Installing Node.js dependencies..."
        - "[[ -f package-lock.json || -f npm-shrinkwrap.json ]] && npm ci --prefer-offline || true"

        # Configure Git
        - echo "Configuring Git..."
        - git config core.quotepath false
    build:
      commands:
        - echo "Building site..."
        - hugo --gc --minify
  artifacts:
    baseDirectory: public
    files:
      - '**/*'
  cache:
    paths:
      - ${HUGO_CACHEDIR}/**/*
      - ${NPM_CONFIG_CACHE}/**/*
Step 3
Commit and push the change to your GitHub repository.
git add -A
git commit -m "Create amplify.yml"
git push
Step 4
Log in to your AWS account, navigate to the Amplify Console, then press the Deploy an app button.
Step 5
Choose a source code provider, then press the Next button.

screen capture

Step 6
Authorize AWS Amplify to access your GitHub account.

screen capture

Step 7
Select your personal account or relevant organization.

screen capture

Step 8
Authorize access to one or more repositories.

screen capture

Step 9
Select a repository and branch, then press the Next button.

screen capture

Step 10
On the “App settings” page, scroll to the bottom then press the Next button. Amplify reads the amplify.yml file you created in Steps 1-3 instead of using the values on this page.
Step 11
On the “Review” page, scroll to the bottom then press the Save and deploy button.
Step 12
When your site has finished deploying, press the Visit deployed URL button to view your published site.

screen capture