Skip to content

Commit dcd3329

Browse files
author
mityax
committed
Updated readme
1 parent 56205df commit dcd3329

1 file changed

Lines changed: 29 additions & 1 deletion

File tree

README.md

Lines changed: 29 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,30 @@
11
# decsync-docker
2-
A minimalistic, up-to-date Dockerfile for decsync
2+
A minimalistic, but batteries-included, up-to-date docker container for running [Decsync](https://github.com/39aldo39/DecSync) as a local CalDav server (using [Radicale](https://github.com/Kozea/Radicale)). This way, Decsync can be easily used with any calendar app supporting CalDav – e.g. Thunderbird or Gnome Calendar.
3+
4+
## Usage
5+
6+
To run the container, and have it automatically start after rebooting, just do:
7+
8+
```bash
9+
docker run \
10+
-v <decsync-directory>:/decsync-data \
11+
-p 5232:5232 \
12+
--name decsync-caldav \
13+
--restart unless-stopped \
14+
ghcr.io/mityax/decsync-docker:main
15+
```
16+
17+
**Remember to** replace `<decsync-directory>` in the command in with the path to your local, synchronised Decsync data directory.
18+
19+
You can then just connect to the local CalDav server using this url: [http://localhost:5232](http://localhost:5232)
20+
21+
When asked for credentials, just enter something random – the server accepts everything as per the defaul configuration, which is fine as long is it is only exposed on the local network.
22+
23+
## Configuration
24+
Should you want to add further server/Radicale configuration, take a look at the [base image](https://github.com/tomsquest/docker-radicale).
25+
26+
## A note on maintenance
27+
While I do not plan to actively maintain this project in terms of adding new features, I will fix bugs and keep it functioning since I'm using this myself. This should not require much manual action though, since the Dockerfile is very simple and based on the upstream [tomsquest/docker-radicale](https://github.com/tomsquest/docker-radicale) image – it is not a copy but an extension thereof, with the minimal required changes to make the official [Radicale Decsync plugin](https://github.com/39aldo39/Radicale-DecSync) work. There should thus not be much room for compatibility issues in future updates of the base image, at least until Radicale v4 is released.
28+
29+
30+

0 commit comments

Comments
 (0)