aboutsummarylogtreecommitdiffstats
path: root/README.md
blob: 16f7e1c67f5e5e3dc3a769f2120b1b40814d2f3f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
# Caddy AUR

Caddy is an HTTP/2 web server written in [go](golang.org) with easy configuration and built-in ACME (let's encrypt) support.
Take a look at [caddyserver.com](https://caddyserver.com/) for more details.

## Migration from 0.8.3 and Previous Versions

Since 0.9, the new [upstream systemd service file](https://github.com/mholt/caddy/blob/master/dist/init/linux-systemd/caddy.service) is bundled with the package.
Some of caddy's default paths, e.g. the certificate directories path, have changed.
The [release notes for 0.9](https://caddyserver.com/blog/caddy-0_9-released) are explaining everything in detail.

The following instructions are only relevant if you used the caddy AUR packages before the 0.9 release.
`www-data` is used as the new default user and group, therefore it needs to be available on the system.
Run the following command to create the system user and group for www-data:

```sh
useradd --system --shell /usr/bin/nologin www-data
```

*Important*: check the permissions of the *web root* and *caddy configuration* and `chown -R www-data:www-data` them if necessary.

TLS assets are now stored in `$HOME/.caddy`, where `$HOME` is the run users home directory.
Caddy will make the migration for you, so don't worry.
You can override the default path by setting the `$CADDYPATH` variable.
The upstream systemd service sets `HOME` for `www-data` to `/etc/ssl/caddy`, hence make sure that the directory exists:

```sh
mkdir -p /etc/ssl/caddy && chown -R www-data:www-data /etc/ssl/caddy
```

The caddy binary is now installed to `/usr/local/bin` instead `/usr/bin`.

*Important*: `import`s are now relative to your `Caddyfile`! The following example illustrates nested imports:
	```ini
	# Caddyfile
	import config/some.site
	import config/default
	...

	# config/some.site
	import default
	...
	```

Have fun with the latest caddy release!

If you've any questions, please create an issue in the [github repo](https://github.com/klingtnet/caddy-AUR).