radicale/README.md

# 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.
Initial commit 2025-02-04 22:13:02 +00:00			`# radicale`

Docker and config 2025-02-05 20:34:33 +00:00			`[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.