|
|
|
|
# Docker-radicale
|
|
|
|
|
This is a dockerized version of a radicale server.
|
|
|
|
|
The official container and documentation was made by [tomsquest](https://hub.docker.com/r/tomsquest/docker-radicale).
|
|
|
|
|
|
|
|
|
|
The `latest` tag at the moment of writing this readme was corrupted.
|
|
|
|
|
The last usable tag was used therefore to guarantee best performance for all users.
|
|
|
|
|
|
|
|
|
|
## Volumes
|
|
|
|
|
Set the following volumes with the -v tag.
|
|
|
|
|
|
|
|
|
|
| Volume-Name | Container mount | Description |
|
|
|
|
|
| ---------------- | --------------- | --------------------------- |
|
|
|
|
|
| radicale\_data | /data | storage for caldav |
|
|
|
|
|
| radicale\_config | /config | storage for radicale config |
|
|
|
|
|
|
|
|
|
|
## Ports
|
|
|
|
|
Set the following ports with the -p tag.
|
|
|
|
|
|
|
|
|
|
| Container Port | Recommended outside port | Protocol | Description |
|
|
|
|
|
| -------------- | ------------------------ | -------- | ------------- |
|
|
|
|
|
| 5232 | 5232 | TCP | WebUI, caldav |
|
|
|
|
|
|
|
|
|
|
## Additional
|
|
|
|
|
There are some special variables to set.
|
|
|
|
|
|
|
|
|
|
| Flag | Usage |
|
|
|
|
|
| ----------- | ---------------------------------------------------------------------- |
|
|
|
|
|
| --read-only | make radicale read-only, caldav can still be changed and used normally |
|
|
|
|
|
|
|
|
|
|
## Setup
|
|
|
|
|
After installation there are a few crucial steps to take to secure your calendars with a login.
|
|
|
|
|
It is important to change the config file which can be found in the docker volume with name `radicale_config` to match the `config`-file.
|
|
|
|
|
|
|
|
|
|
Following this you need to make sure there is a password file in the docker volume `radicale_data` called `users`.
|
|
|
|
|
The password will be encrypted using `bcrypt`.
|
|
|
|
|
Steps to create a file with a user and password:
|
|
|
|
|
- You will have to install the package which includes `htpasswd`; for debian based distributions this is `apt install apache2-utils`
|
|
|
|
|
- `cd /var/lib/docker/volumes/radicale\_data/\_data` - go to the volume
|
|
|
|
|
- `touch ./users` - create a file called users
|
|
|
|
|
- `htpasswd -B ./users username` - add user with name and password to the file (change `username` to your desired username)
|
|
|
|
|
|
|
|
|
|
Now you can go to the exposed port and login with your chosen username and password.
|
|
|
|
|
If you only added one user you shouldn't be able to login with any other data than your username and password.
|
