mirror of
				https://github.com/gohugoio/hugo.git
				synced 2024-05-11 05:54:58 +00:00 
			
		
		
		
	
		
			
	
	
		
			94 lines
		
	
	
		
			3.6 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
		
		
			
		
	
	
			94 lines
		
	
	
		
			3.6 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
|  | --- | ||
|  | title: Host on Render | ||
|  | linktitle: Host on Render | ||
|  | description: Host your Hugo site for free with Render's global CDN, fully-managed SSL and auto deploys from GitHub. | ||
|  | date: 2019-06-06 | ||
|  | publishdate: 2019-06-06 | ||
|  | lastmod: 2019-06-21 | ||
|  | categories: [hosting and deployment] | ||
|  | keywords: [render,hosting,deployment] | ||
|  | authors: [Anurag Goel] | ||
|  | menu: | ||
|  |   docs: | ||
|  |     parent: "hosting-and-deployment" | ||
|  |     weight: 10 | ||
|  | weight: 10 | ||
|  | sections_weight: 10 | ||
|  | draft: false | ||
|  | aliases: [] | ||
|  | toc: true | ||
|  | --- | ||
|  | 
 | ||
|  | ## Introduction
 | ||
|  | 
 | ||
|  | [Render](https://render.com) 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. | ||
|  | - Automatic SSL certificates through [Let's Encrypt](https://letsencrypt.org). | ||
|  | - Instant cache invalidation with a lightning fast, global CDN. | ||
|  | - Unlimited collaborators. | ||
|  | - Unlimited [custom domains](https://render.com/docs/custom-domains). | ||
|  | - Automatic [Brotli compression](https://en.wikipedia.org/wiki/Brotli) for faster sites. | ||
|  | - Native HTTP/2 support. | ||
|  | - [Pull Request Previews](https://render.com/docs/pull-request-previews). | ||
|  | - Automatic HTTP → HTTPS redirects. | ||
|  | - Custom URL redirects and rewrites. | ||
|  | 
 | ||
|  | ## Assumptions
 | ||
|  | 
 | ||
|  | * You have an account with GitHub. | ||
|  | * 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 **Web Service** on Render, and give Render permission to access your GitHub repo. | ||
|  | 2. Use the following values during creation: | ||
|  | 
 | ||
|  |   Field                | Value | ||
|  |   -------------------  |  ------------------- | ||
|  |  **Environment**       | `Static Site` | ||
|  |  **Build Command**     | `hugo --gc --minify` (or our 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 GitHub. | ||
|  | 
 | ||
|  | 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](https://render.com/docs/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](https://render.com/docs/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. | ||
|  | 
 | ||
|  | 
 | ||
|  | [Quick Start]: /getting-started/quick-start/ |