HUGO Docs

  • News
  • About
    • In this section
    • Introduction
    • Features
    • Privacy
    • Security
    • License
  • Installation
    • In this section
    • macOS
    • Linux
    • Windows
    • BSD
  • Getting started
    • In this section
    • Quick start
    • Basic usage
    • Directory structure
    • Configuration
    • Configure markup
    • Glossary of terms
    • External learning resources
  • Quick reference
    • In this section
    • Emojis
    • Functions
    • Methods
    • Page collections
  • Content management
    • In this section
    • Organization
    • Page bundles
    • Content formats
    • Front matter
    • Build options
    • Page resources
    • Image processing
    • Shortcodes
    • Related content
    • Sections
    • Content types
    • Archetypes
    • Taxonomies
    • Summaries
    • Links and cross references
    • URL management
    • Menus
    • Comments
    • Multilingual
    • Markdown attributes
    • Syntax highlighting
    • Diagrams
    • Mathematics
    • Data sources
    • Content adapters
  • Templates
    • In this section
    • Introduction
    • Template types
    • Lookup order
    • Base templates
    • Home templates
    • Single templates
    • Section templates
    • Taxonomy templates
    • Term templates
    • Partial templates
    • Content view templates
    • Shortcode templates
    • Sitemap templates
    • RSS templates
    • 404 templates
    • robots.txt templates
    • Menus
    • Pagination
    • Embedded templates
    • Custom output formats
  • Functions
    • In this section
    • cast
    • collections
    • compare
    • crypto
    • css
    • data
    • debug
    • diagrams
    • encoding
    • fmt
    • global
    • go template
    • hugo
    • images
    • inflect
    • js
    • lang
    • math
    • openapi3
    • os
    • partials
    • path
    • reflect
    • resources
    • safe
    • strings
    • templates
    • time
    • transform
    • urls
  • Methods
    • In this section
    • Duration
    • Menu
    • Menu entry
    • Page
    • Pager
    • Pages
    • Resource
    • Shortcode
    • Site
    • Taxonomy
    • Time
  • Render hooks
    • In this section
    • Introduction
    • Code blocks
    • Headings
    • Images
    • Links
  • Hugo Modules
    • In this section
    • Configure Hugo modules
    • Use Hugo Modules
    • Theme components
  • Hugo Pipes
    • In this section
    • Introduction
    • Transpile Sass to CSS
    • PostCSS
    • PostProcess
    • JavaScript building
    • Babel
    • Asset minification
    • Concatenating assets
    • Fingerprinting and SRI hashing
    • Resource from string
    • Resource from template
  • CLI
  • Troubleshooting
    • In this section
    • Audit
    • Logging
    • Inspection
    • Deprecation
    • Performance
    • FAQs
  • Developer tools
    • In this section
    • Editor plugins
    • Front-ends
    • Search
    • Migrations
    • Other projects
  • Hosting and deployment
    • In this section
    • Hugo Deploy
    • Deploy with Rclone
    • Deploy with Rsync
    • Host on 21YunBox
    • Host on AWS Amplify
    • Host on Azure Static Web Apps
    • Host on Cloudflare Pages
    • Host on Firebase
    • Host on GitHub Pages
    • Host on GitLab Pages
    • Host on KeyCDN
    • Host on Netlify
    • Host on Render
  • Contribute
    • In this section
    • Development
    • Documentation
    • Themes
  • Maintenance
HOSTING AND DEPLOYMENT

Host on Render

Host your Hugo site for free with Render’s global CDN, fully-managed SSL and auto deploys from GitHub.

Introduction

Render is a fully-managed cloud platform where you can host static sites, backend APIs, databases, cron jobs, and all your other apps in one place.

Static sites are completely free on Render and include the following:

  • Continuous, automatic builds & deploys from GitHub and GitLab.
  • Automatic SSL certificates through Let’s Encrypt.
  • Instant cache invalidation with a lightning fast, global CDN.
  • Unlimited collaborators.
  • Unlimited custom domains.
  • Automatic Brotli compression for faster sites.
  • Native HTTP/2 support.
  • Pull Request Previews.
  • Automatic HTTP → HTTPS redirects.
  • Custom URL redirects and rewrites.

Assumptions

  • You have an account with GitHub or GitLab.
  • You have completed the Quick Start or have a Hugo website you are ready to deploy and share with the world.
  • You have a Render account. You can sign up at https://render.com/register.

Deployment

You can set up a Hugo site on Render in two quick steps:

  1. Create a new Static Site on Render, and give Render permission to access your GitHub/GitLab repo.
  2. Use the following values during creation:
Field Value
Build Command hugo --gc --minify (or your own build command)
Publish Directory public (or your own output directory)

That’s it! Your site will be live on your Render URL (which looks like yoursite.onrender.com) as soon as the build is done.

Continuous deploys

Now that Render is connected to your repo, it will automatically build and publish your site any time you push to your GitHub/GitLab.

You can choose to disable auto deploys under the Settings section for your site and deploy it manually from the Render dashboard.

CDN and cache invalidation

Render hosts your site on a global, lightning fast CDN which ensures the fastest possible download times for all your users across the globe.

Every deploy automatically and instantly invalidates the CDN cache, so your users can always access the latest content on your site.

Custom domains

Add your own domains to your site easily using Render’s custom domains guide.

Pull Request previews

With Pull Request (PR) previews, you can visualize changes introduced in a pull request instead of simply relying on code reviews.

Once enabled, every PR for your site will automatically generate a new static site based on the code in the PR. It will have its own URL, and it will be deleted automatically when the PR is closed.

Read more about Pull Request Previews on Render.

Hugo themes

Render automatically downloads all Git submodules defined in your Git repo on every build. This way Hugo themes added as submodules work as expected.

Support

Chat with Render developers at https://render.com/chat or email support@render.com if you need help.

See also

  • Host on 21YunBox
  • Host on Firebase
  • Host on GitLab Pages
  • Host on KeyCDN
  • Content formats

On this page

  • Introduction
  • Assumptions
  • Deployment
  • Continuous deploys
  • CDN and cache invalidation
  • Custom domains
  • Pull Request previews
  • Hugo themes
  • Support
Last updated: July 5, 2024: hugo doc (a0ca0ab)
Improve this page
 

The Hugo logos are copyright © Steve Francia 2013–2024.

The Hugo Gopher is based on an original work by Renée French.

  • News
  • About
  • Installation
  • Getting started
  • Quick reference
  • Content management
  • Templates
  • Functions
  • Methods
  • Render hooks
  • Hugo Modules
  • Hugo Pipes
  • CLI
  • Troubleshooting
  • Developer tools
  • Hosting and deployment
  • Contribute
  • Maintenance