tiyn/wiki
1
0
Fork 0
mirror of https://github.com/tiyn/wiki.git synced 2026-02-22 10:24:47 +01:00
Code Issues Projects Releases Wiki Activity

markdown syntax: formatted all files with prettier

Browse Source
This commit is contained in:
TiynGER
2020-11-01 16:06:38 +01:00
parent 0b7e2aa41b
commit 2951efa92e
45 changed files with 762 additions and 625 deletions
Download Patch File Download Diff File Expand all files Collapse all files

49
wiki/radicale.md
View File

@@ -10,48 +10,54 @@ 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 |
| 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 |
| `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 |
| Flag | Usage |
| ------------- | ---------------------------------------------------------------------- |
| `--read-only` | make radicale read-only, caldav can still be changed and used normally |
#### Rebuild
```
```shell
#/bin/sh
docker stop radicale
docker rm radicale
docker pull tomsquest/docker-radicale:2.1.11.4
docker run --name radicale \
--restart unless-stopped \
--read-only \
--restart unless-stopped \
--read-only \
-p 5232:5232 \
-v radicale_data:/data \
-v radicale_config:/config \
-v radicale_config:/config \
-d tomsquest/docker-radicale:2.1.11.4
```
#### Configuration
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.
```
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.
```txt
# -*- mode: conf -*-
# vim:ft=cfg
@@ -187,13 +193,18 @@ type = internal
#Access-Control-Allow-Origin = *
```
Following this you need to make sure there is a password file in the docker volume `radicale_data` called `users`.
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`
- 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)
- `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.
If you only added one user you shouldn't be able to login with any other data
than your username and password.