Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
lennart-k committed Nov 3, 2024
1 parent 41254be commit eb960a3
Showing 1 changed file with 39 additions and 2 deletions.
41 changes: 39 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,46 @@
# Rustical (WIP)
# RustiCal

a calendar server
a CalDAV/CardDAV server

## Warning: State of the project

This software is not stable yet and things are subject to change.

## Installation

### Manual

```sh
cargo install --git https://github.com/lennart-k/rustical
```

### Docker

```sh
docker run -p 4000:4000 -v YOUR_CONFIG_TOML:/etc/rustical/config.toml -v YOUR_DATA_DIRECTORY:YOUR_DATA_DIRECTORY ghcr.io/lennart-k/rustical
```

## Configuration

You can generate a default `config.toml` with
```sh
rustical gen-config
```
There, you can customize your username, password, and app tokens.
Password hashes can be generated with
```sh
rustical pwhash
```

### Password vs app tokens

The password is meant as a password you use to log in to the frontend.
Since it's sensitive information, the secure but slow hash algorithm `argon2` is chosen.

I recommend to generate random app tokens for each CalDAV/CardDAV client.
These can use the faster `pbkdf2` algorithm.


## Todo

- [ ] CalDAV
Expand Down

0 comments on commit eb960a3

Please sign in to comment.