docs: Add tips for permissions errors in tutorials; explain durability

This commit is contained in:
Matthew Holt 2020-04-08 13:34:18 -06:00
parent fdabe3dde2
commit d3a35d67e8
No known key found for this signature in database
GPG key ID: 2A349DD577D586A5
3 changed files with 14 additions and 1 deletions

View file

@ -31,6 +31,10 @@ The first thing you should type is your site's [address](/docs/caddyfile/concept
localhost
```
<aside class="tip">
If the HTTP and HTTPS ports (80 and 443, respectively) are privileged ports on your OS, you will either need to run with elevated privileges or use a higher port. To use a higher port, just change the address to something like <code>localhost:2015</code>. You'll still get HTTPS unless you turn it off.
</aside>
Then hit enter and type what you want it to do. For this tutorial, make your Caddyfile look like this:
```
@ -43,6 +47,10 @@ Save that and run Caddy (since this is a training tutorial, we'll use the `--wat
<pre><code class="cmd bash">caddy run --watch</code></pre>
<aside class="tip">
If you get permissions errors, try using a higher port in your address, like <code>localhost:2015</code> for example, or run with elevated privileges.
</aside>
The first time, you'll be asked for your password. This is so Caddy can serve your site over HTTPS.
<aside class="tip">Caddy serves all sites over HTTPS by default as long as a host or IP is part of the site's address. <a href="/docs/automatic-https">Automatic HTTPS</a> can be disabled by prefixing the address with <code>http://</code> explicitly.</aside>