aboutsummaryrefslogtreecommitdiffhomepage
path: root/docs/content/en/hosting-and-deployment
diff options
context:
space:
mode:
authorBjørn Erik Pedersen <[email protected]>2022-04-08 13:32:01 +0200
committerBjørn Erik Pedersen <[email protected]>2022-04-08 13:32:01 +0200
commit5b5dcb8d5a4669e1768951b452cfd53c6b25825c (patch)
treec364895dfba48457afd2b83ceaae2e085fae0428 /docs/content/en/hosting-and-deployment
parentffe3eb9195e0f3184df9fc416d5f6ee12fdba91b (diff)
parentec920363cdeb687c8bcac9c242767d366fb058cb (diff)
downloadhugo-5b5dcb8d5a4669e1768951b452cfd53c6b25825c.tar.gz
hugo-5b5dcb8d5a4669e1768951b452cfd53c6b25825c.zip
Merge commit 'ec920363cdeb687c8bcac9c242767d366fb058cb'
Diffstat (limited to 'docs/content/en/hosting-and-deployment')
-rw-r--r--docs/content/en/hosting-and-deployment/deployment-with-rclone.md57
-rw-r--r--docs/content/en/hosting-and-deployment/hosting-on-keycdn.md4
-rw-r--r--docs/content/en/hosting-and-deployment/hosting-on-render.md2
3 files changed, 59 insertions, 4 deletions
diff --git a/docs/content/en/hosting-and-deployment/deployment-with-rclone.md b/docs/content/en/hosting-and-deployment/deployment-with-rclone.md
new file mode 100644
index 000000000..e9feb765a
--- /dev/null
+++ b/docs/content/en/hosting-and-deployment/deployment-with-rclone.md
@@ -0,0 +1,57 @@
+---
+title: Deployment with Rclone
+linktitle: Deployment with Rclone
+description: If you have access to your web host with SFTP/FTP/SSH/HTTP(DAV), you can use rclone to incrementally deploy your entire Hugo website.
+date: 2021-08-09
+publishdate: 2021-08-09
+lastmod: 2021-08-09
+categories: [hosting and deployment]
+keywords: [rclone,sftp,deployment]
+authors: [Daniel F. Dickinson]
+menu:
+ docs:
+ parent: "hosting-and-deployment"
+ weight: 80
+weight: 80
+sections_weight: 80
+draft: false
+aliases: [/tutorials/deployment-with-rclone/]
+toc: true
+notesforauthors:
+---
+
+## Assumptions
+
+* A web host running a web server. This could be a shared hosting environment or a VPS.
+* Access to your web host with any of the [protocols supported by rclone](https://rclone.org/#providers), such as SFTP.
+* A functional static website built with Hugo
+* Deploying from an [Rclone](https://rclone.org) compatible operating system
+* You have [installed Rclone](https://rclone.org/install/).
+
+**NB**: You can remove ``--interactive`` in the commands below once you are comfortable with rclone, if you wish. Also, ``--gc`` and ``--minify`` are optional in the ``hugo`` commands below.
+
+## Getting Started
+
+The spoiler is that you can even deploy your entire website from any compatible OS with no configuration. Using SFTP for example:
+
+```
+hugo --gc --minify
+rclone sync --interactive --sftp-host sftp.example.com --sftp-user www-data --sftp-ask-password public/ :sftp:www/
+```
+
+## Configure Rclone for Even Easier Usage
+
+The easiest way is simply to run ``rclone config``.
+
+The [Rclone docs](https://rclone.org/docs/) provide [an example of configuring Rclone to use SFTP](https://rclone.org/sftp/).
+
+For the next commands, we will assume you configured a remote you named ``hugo-www``
+
+The above 'spoiler' commands could become:
+
+```
+hugo --gc --minify
+rclone sync --interactive public/ hugo-www:www/
+```
+
+After you issue the above commands (and respond to any prompts), check your website and you will see that it is deployed.
diff --git a/docs/content/en/hosting-and-deployment/hosting-on-keycdn.md b/docs/content/en/hosting-and-deployment/hosting-on-keycdn.md
index 8d9cb0e63..bec8b36e4 100644
--- a/docs/content/en/hosting-and-deployment/hosting-on-keycdn.md
+++ b/docs/content/en/hosting-and-deployment/hosting-on-keycdn.md
@@ -83,11 +83,11 @@ The Zone ID and API key are used to purge your zone – it’s not strictly need
Now it’s time to push the newly created repository to GitLab:
```
-git remote add origin [email protected]:youruser/ciexample.git
+git remote add origin [email protected]:youruser/ci-example.git
git push -u origin master
```
-You can watch the progress and CI job output in your Gitlab project under “Pipelines”.
+You can watch the progress and CI job output in your Gitlab project under “Pipelines”.
After verifying your CI job ran without issues, first check that your GitLab page shows up under `https://youruser.gitlab.io/reponame/` (it might look broken depending on your browser settings as all links point to your KeyCDN zone – don’t worry about that) and then by heading to whatever Zone alias / Zone URL you defined.
diff --git a/docs/content/en/hosting-and-deployment/hosting-on-render.md b/docs/content/en/hosting-and-deployment/hosting-on-render.md
index 7a77742e2..73b20bcb2 100644
--- a/docs/content/en/hosting-and-deployment/hosting-on-render.md
+++ b/docs/content/en/hosting-and-deployment/hosting-on-render.md
@@ -4,7 +4,6 @@ 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: 2020-01-01
categories: [hosting and deployment]
keywords: [hosting,deployment]
authors: [Anurag Goel]
@@ -88,5 +87,4 @@ Render automatically downloads all Git submodules defined in your Git repo on ev
Chat with Render developers at https://render.com/chat or email `[email protected]` if you need help.
-
[Quick Start]: /getting-started/quick-start/