Go to file
2025-02-06 16:21:53 -05:00
config Fix unicode C 2025-02-05 15:40:07 -05:00
.gitignore Docker and config 2025-02-05 15:34:33 -05:00
docker-compose.yaml Docker and config 2025-02-05 15:34:33 -05:00
README.md Add to client 2025-02-06 16:21:53 -05:00

radicale

Radicale 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.

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.
services:
  radicale:
    labels:
      - "traefik.http.routers.radicale.rule=Host(`radicale.moeny.ai`)"

and

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.

  1. 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 (:).

  2. Once ready, run docker-compose up -d to start the server.

  3. 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.

Using Radicale

MacOS Calendar App

  1. Open the MacOS Calendar app
  2. In the top menu, click Calendar > Add Account
  3. In the pop-up window, select Other CalDAV Account and click Continue
  4. In the next screen:
Account Type: Manual
Username: Your Radicale username
Password: Your Radicale password
Server Address: The domain or IP where Radicale is running, e.g., radicale.moeny.ai
  1. Sign In

iOS Calendar App

  1. Open Settings > Apps > Calendar > Calendar Accounts > Add Account
  2. Select Other from the bottom of the list
  3. Under Calendars, tap Add CalDAV Account
  4. Fill in the details:
Server: radicale.moeny.ai
Username: Your Radicale username
Password: Your Radicale password
Description: Name it whatever you like
  1. Tap Next

For Other Clients

Refer to the Supported Clients section of the Radicale documentation.

What's next?

Once your client of choice is set up, your Radicale calendars will automatically sync between client and server. You can create collections in the web interface, as well as view those created in the client you are using. If your events don't show up, refresh the client (⌘R on macOS or open the calendars tab and swipe down on the list of events on iOS).