30 lines
1.4 KiB
Markdown
30 lines
1.4 KiB
Markdown
# radicale
|
|
|
|
[Radicale](https://radicale.org/v3.html) is a small but powerful CalDAV (calendars, to-do lists) and CardDAV (contacts) server. The Docker configuration is based off of the work in [docker-radicale](https://github.com/tomsquest/docker-radicale).
|
|
|
|
## Quick start
|
|
1. All of the necessary files to start a Radicale server are in this repo. Begin by editing the following lines in the docker-compose.yaml file to reflect your hostname and the email address you want to use for Let's Encrypt.
|
|
|
|
``` yaml
|
|
services:
|
|
radicale:
|
|
labels:
|
|
- "traefik.http.routers.radicale.rule=Host(`radicale.moeny.ai`)"
|
|
```
|
|
|
|
and
|
|
|
|
``` yaml
|
|
services:
|
|
traefik:
|
|
command:
|
|
- --certificatesresolvers.le.acme.email=radicale@moeny.ai
|
|
```
|
|
|
|
Make sure you also have a domain DNS A record pointed to your server's public IP for the hostname you gave to traefik. To set up your own DNS server, see our [bind9 repo](https://gitea.moeny.ai/moeny/bind9).
|
|
|
|
2. Rename `config/users.sample` to `users` and edit the usernames and passwords it contains. Ensure that each line contains a username and bcrypt-hashed password, separated by a colon (:).
|
|
|
|
3. Once ready, run `docker-compose up -d` to start the server.
|
|
|
|
4. You should then be able to access Radicale at the URL you set up with traefik earlier. The usernames and passwords to log in are the ones added to the `users` file. Use the non-hashed password. |