# evcc-calendar

evcc-calendar is a self-hosted home automation app. Sets a one-time evcc charging plan (target SoC and time) for your car from calendar appointments read through Home Assistant. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/6978/evcc-calendar

## Description

Sets a one-time evcc charging plan (target SoC and time) for your car from calendar appointments read through Home Assistant. Starts in dry-run mode: nothing is written until you set dry_run to false in config.yaml. On first start an example config.yaml is created in the appdata folder; edit it, then restart the container. Requires evcc, Home Assistant and an OpenRouteService API key.

## Platform availability

Available on 1 of 9 platforms: Unraid.

## Health score

40/100 (Fair), based on 3 of 4 factors.
- Maintained: 75 (last commit 2 days ago)
- Popular: 0 (0 GitHub stars)
- Easy to install: 20 (1 install platform, Docker image)

## Links

- Unraid: https://ca.unraid.net/apps/evcc-calendar-06qqcc31n3wlbr?q=evcc-calendar
- GitHub: https://github.com/cmdrsabre/evcc-calendar

## Common questions

### Does evcc-calendar send a charging plan to evcc immediately after startup?

No. It starts in dry-run mode and nothing is written until dry_run is set to false in config.yaml.

### Which port is used for the status page in the Docker setup?

The container listens on port 80 internally, and the published port defaults to 8180 via HOST_PORT in .env.

### Which credentials need to be added to .env before running the container?

HA_TOKEN, EVCC_API_KEY, and ORS_KEY must be filled in. Never share the .env file.

### Can multiple live instances of evcc-calendar run at the same time?

No. Only one instance may run live, so stop the first container before starting another.

### Where is the configuration file stored when running on Unraid?

The configuration file is expected at /mnt/user/appdata/evcc-kalender/config.yaml.

---
Source: Our Local Host (https://ourlocalhost.com/app/6978/evcc-calendar), the self-hosted and open-source app directory.