beaverhabits-caldav-bridge/README.md

# Beaverhabits - CalDAV bridge

This is a simple container that can connect to Beaverhabits and run a calDAV server that hosts the habits as tasks.

It was mostly generated by AI (Gemini + GPT) and may have bad code, security problems or poor performance, but for anyone else who wants a quick fix, here it is.

I made this to use with Home Assistant's CalDAV integration so I didn't have to write a custom integration.

## Usage

Start up the container with docker-compose

```yaml
version: '3.8'

services:
  caldav-bridge:
    build:
      # Change this to the root of the repository
      context: ./bridge
    ports:
      - "8004:8000"
    environment:
      # FILL THESE IN
      # If you are using TRUSTED_LOCAL_EMAIL, leave the username and password blank
      TIMEZONE: EST
      BEAVERHABITS_URL: "" # no path, just the base URL
      BEAVERHABITS_USERNAME: "" # yes i know this is bad
      BEAVERHABITS_PASSWORD: "" # however, i don't care
    restart: unless-stopped
```

Then configure it in home assistant with the URL

`http://[ip]:8004/caldav/`