### Install Homechart via Helm Source: https://github.com/candiddev/homechart/blob/main/docs/guides/get-homechart/self-hosted.md Add the Homechart Helm repository and install the chart into a Kubernetes cluster. ```bash helm repo add homechart https://helm.homechart.app/ helm install my-homechart homechart/homechart ``` -------------------------------- ### Manage Homechart via CLI Source: https://context7.com/candiddev/homechart/llms.txt Commands for starting the server and generating VAPID keys for Web Push notifications. ```bash # Run the Homechart server ./homechart_linux_amd64 run # Generate VAPID keys for Web Push notifications ./homechart_linux_amd64 generate-vapid # Output: VEIYXV6qF_enUzycyQYdplDUgi05UM4lPh_FTzYmwX8 # Generate VAPID using container docker run -it --rm ghcr.io/candiddev/homechart generate-vapid ``` -------------------------------- ### Authelia Command Line Execution Source: https://github.com/candiddev/homechart/blob/main/docs/guides/sso.md Starts the Authelia service using the provided configuration file. ```bash ./authelia-linux-amd64 --config authelia.yaml ``` -------------------------------- ### Homechart Command Line Execution Source: https://github.com/candiddev/homechart/blob/main/docs/guides/sso.md Starts the Homechart application with proxy header configurations. ```bash homechart_app_proxyAddress=[::1] homechart_app_proxyHeaderEmail=Remote-Email homechart_app_proxyHeaderName=Remote-Name ./homechart_linux_amd64 -c config.json serve ``` -------------------------------- ### Traefik Command Line Execution Source: https://github.com/candiddev/homechart/blob/main/docs/guides/sso.md Starts the Traefik service with the specified dynamic configuration file. ```bash ./traefik --entrypoints.https=true --entrypoints.https.address=:8443 --providers.file.filename=traefik-dynamic.yaml ``` -------------------------------- ### Example OIDC Identity Token Source: https://github.com/candiddev/homechart/blob/main/docs/guides/sso.md This JSON object represents an example OIDC identity token that Homechart exposes to applications. It contains user details and permissions. ```json { "email": "jennifer@no-email.example.com", "email_verified": true, "locale": "en", "name": "Jennifer", "permissions": { "auth": 1, "bookmarks": 2, "budget": 2, "calendar": 2, "cook": 2, "health": 0, "inventory": 2, "notes": 2, "plan": 2, "reward": 2, "secrets": 2, "shop": 2 }, "permissions_labels": { "Kids - Edit": 0, "Kids - None": 2, "Kids - View": 1 }, "updated_at": "2025-10-22T18:58:51.643851Z" } ``` -------------------------------- ### Example OIDC Identity Token Issued by Homechart Source: https://context7.com/candiddev/homechart/llms.txt This JSON represents an example OIDC identity token issued by Homechart, containing user information and permissions. Permission levels are indicated by numerical values. ```json // Example OIDC identity token issued by Homechart { "email": "jennifer@example.com", "email_verified": true, "locale": "en", "name": "Jennifer", "permissions": { "auth": 1, "bookmarks": 2, "budget": 2, "calendar": 2, "cook": 2, "health": 0, "inventory": 2, "notes": 2, "plan": 2, "reward": 2, "secrets": 2, "shop": 2 }, "permissions_labels": { "Kids - Edit": 0, "Kids - None": 2, "Kids - View": 1 }, "updated_at": "2025-10-22T18:58:51.643851Z" } // Permission levels: 0 = Edit, 1 = View, 2 = None ``` -------------------------------- ### Minimal OIDC Provider Configuration Source: https://github.com/candiddev/homechart/blob/main/docs/guides/sso.md This JSON configuration shows a minimal setup for integrating an OIDC provider like Google with a self-hosted Homechart instance. Ensure 'app_baseURL' is correctly set in your Homechart configuration. ```json { "oidc": { "google": { "clientID": "a-client-id", "clientSecret": "a-client-secret", "displayName": "Google", "oidcIssuerURL": "https://accounts.google.com" } } } ``` -------------------------------- ### Update Homechart Container Source: https://github.com/candiddev/homechart/blob/main/docs/guides/get-homechart/self-hosted.md Pull the latest container image to update an existing Homechart installation. ```bash docker pull ghcr.io/candiddev/homechart:latest ``` -------------------------------- ### Deploy Homechart via CLI and Container Runtimes Source: https://context7.com/candiddev/homechart/llms.txt Commands for initializing the PostgreSQL database and launching Homechart using Docker, Podman, or Kubernetes. ```bash # PostgreSQL setup - create database and role psql -c "CREATE DATABASE homechart;" psql -c "CREATE ROLE \"homechart\" WITH CREATEDB LOGIN PASSWORD 'homechart';" psql -c "REVOKE ALL PRIVILEGES ON SCHEMA public FROM public;" psql -c "GRANT ALL PRIVILEGES ON DATABASE homechart TO \"homechart\";" psql -c "GRANT ALL PRIVILEGES ON SCHEMA public TO \"homechart\";" # Docker - Single command deployment docker run -e 'homechart_database_uri=postgresql://postgres:postgres@postgres/postgres' \ -p 3000:3000 -d ghcr.io/candiddev/homechart:latest # Podman alternative podman run -e homechart_database_uri=postgresql://homechart:homechart@postgresql/homechart \ -p 3000:3000 -d ghcr.io/candiddev/homechart:latest # Kubernetes via Helm helm repo add homechart https://helm.homechart.app/ helm install my-homechart homechart/homechart # Update container to latest version docker pull ghcr.io/candiddev/homechart:latest ``` -------------------------------- ### Run Homechart with Podman Source: https://github.com/candiddev/homechart/blob/main/docs/guides/get-homechart/self-hosted.md Deploy Homechart using Podman with a specific database connection string. ```bash podman run -e homechart_database_uri=postgresql://homechart:homechart@postgresql/homechart -p 3000:3000 -d ghcr.io/candiddev/homechart:latest ``` -------------------------------- ### Configure Homechart via Environment Variables Source: https://context7.com/candiddev/homechart/llms.txt Alternative configuration method using the homechart_ prefix, suitable for containerized environments. ```bash # Core configuration via environment variables export homechart_app_baseURL="https://homechart.example.com" export homechart_app_adminEmailAddresses='["admin@example.com"]' export homechart_app_disableSignup=true export homechart_app_port=3000 # Database connection export homechart_database_uri="postgresql://homechart:password@localhost/homechart" # SMTP for email notifications export homechart_smtp_fromAddress="homechart@example.com" export homechart_smtp_hostname="smtp.example.com" export homechart_smtp_port=587 export homechart_smtp_username="user" export homechart_smtp_password="pass" # Run Homechart server ./homechart_linux_amd64 run ``` -------------------------------- ### Run Homechart with Docker Source: https://github.com/candiddev/homechart/blob/main/docs/guides/get-homechart/self-hosted.md Deploy Homechart using a single Docker command with the required database URI environment variable. ```bash docker run -e 'homechart_database_uri=postgresql://postgres:postgres@postgres/postgres' -p 3000:3000 -d ghcr.io/candiddev/homechart:latest ``` -------------------------------- ### Authelia Configuration Source: https://github.com/candiddev/homechart/blob/main/docs/guides/sso.md Sets up the Authelia server, authentication backend, and session management. ```yaml server: host: 0.0.0.0 port: 9091 log: level: debug jwt_secret: C57E160E9CE711D214BF4CCF407DE6C64FCF19A7C20E7C6D7C2FF18826A7E1AA default_redirection_url: https://auth.example.com:8443 authentication_backend: file: path: ./users.yaml password: algorithm: argon2id iterations: 1 salt_length: 16 parallelism: 8 memory: 1024 # blocks this much of the RAM. Tune this. access_control: default_policy: one_factor session: name: authelia_session domain: example.com storage: encryption_key: superdupersecretsecret local: path: ./db.sqlite3 notifier: filesystem: filename: ./notification.txt ``` -------------------------------- ### Show Current Homechart Configuration Source: https://context7.com/candiddev/homechart/llms.txt Execute this command to display the current configuration of the Homechart application. ```bash ./homechart_linux_amd64 show-config ``` -------------------------------- ### Seed Homechart Database with Mock Data Source: https://context7.com/candiddev/homechart/llms.txt Use this command to populate the Homechart database with mock data for testing purposes. The output will be saved to the specified JSON file. ```bash ./homechart_linux_amd64 seed /tmp/seed-output.json ``` -------------------------------- ### Configure Homechart with Docker Compose Source: https://context7.com/candiddev/homechart/llms.txt Full stack deployment configuration including the Homechart application and a PostgreSQL database service. ```yaml # docker-compose.yml version: "3" services: homechart: depends_on: - postgres environment: homechart_database_uri: postgresql://postgres:postgres@postgres/postgres image: ghcr.io/candiddev/homechart:latest ports: - "3000:3000" restart: always postgres: environment: POSTGRES_PASSWORD: postgres image: docker.io/postgres:16 restart: always volumes: - postgres:/var/lib/postgresql/data volumes: postgres: {} # Deploy with: docker-compose up -d ``` -------------------------------- ### Deploy Homechart with Docker Compose Source: https://github.com/candiddev/homechart/blob/main/docs/guides/get-homechart/self-hosted.md Define the Homechart service and its PostgreSQL dependency using a docker-compose.yml file. ```yaml version: "3" services: homechart: depends_on: - postgres environment: homechart_database_uri: postgresql://postgres:postgres@postgres/postgres image: ghcr.io/candiddev/homechart:latest ports: - "3000:3000" restart: always postgres: environment: POSTGRES_PASSWORD: postgres image: docker.io/postgres:16 restart: always volumes: - postgres:/var/lib/postgresql/data volumes: postgres: {} ``` -------------------------------- ### Run Homechart with Proxy Header Authentication Source: https://context7.com/candiddev/homechart/llms.txt This command executes the Homechart application with environment variables set for proxy address and email/name headers, enabling SSO through Traefik and Authelia. ```bash homechart_app_proxyAddress="[::1]" \ homechart_app_proxyHeaderEmail="Remote-Email" \ homechart_app_proxyHeaderName="Remote-Name" \ ./homechart_linux_amd64 -c config.json run ``` -------------------------------- ### Configure OIDC Authentication Providers Source: https://context7.com/candiddev/homechart/llms.txt This JSON configuration sets up OpenID Connect providers for single sign-on. Replace placeholder values with your actual client IDs and secrets. ```json { "oidc": { "google": { "clientID": "your-google-client-id.apps.googleusercontent.com", "clientSecret": "your-google-client-secret", "displayName": "Google", "oidcIssuerURL": "https://accounts.google.com" }, "microsoft": { "clientID": "your-microsoft-client-id", "clientSecret": "your-microsoft-client-secret", "displayName": "Microsoft", "oidcIssuerURL": "https://login.microsoftonline.com/consumers/v2.0" }, "apple": { "authURLParams": { "response_mode": "form_post" }, "clientID": "your-apple-service-id", "clientSecretJWTClaimsReg": { "aud": "https://appleid.apple.com", "exp": 12960000, "iss": "your-apple-team-id", "sub": "your-apple-service-id" }, "clientSecretJWTKey": "your-converted-jwt-key", "displayName": "Apple", "oidcIssuerURL": "https://appleid.apple.com" } } } ``` -------------------------------- ### CLI Commands Source: https://github.com/candiddev/homechart/blob/main/docs/references/cli.md This section details the available commands for the Homechart CLI. ```APIDOC ## `generate-vapid` ### Description Generate a private and public key for use with Web Push. See {{% config webPush %}} for more information. ### Method Not specified (CLI command) ### Endpoint Not applicable (CLI command) ### Parameters None ### Request Example ```bash homechart generate-vapid ``` ### Response None specified. ``` ```APIDOC ## `run` ### Description Run Homechart server. ### Method Not specified (CLI command) ### Endpoint Not applicable (CLI command) ### Parameters None ### Request Example ```bash homechart run ``` ### Response None specified. ``` ```APIDOC ## `seed [output path]` ### Description Seed the database with mock data and save the output to as JSON to the output path. ### Method Not specified (CLI command) ### Endpoint Not applicable (CLI command) ### Parameters #### Path Parameters - **output path** (string) - Required - The path where the seeded JSON data will be saved. ``` ```APIDOC ## `show-config` ### Description Print the current configuration as JSON or YAML. ### Method Not specified (CLI command) ### Endpoint Not applicable (CLI command) ### Parameters None ### Request Example ```bash homechart show-config ``` ### Response None specified. ``` ```APIDOC ## `tasks-*` ### Description Manually run background maintenance tasks. ### Method Not specified (CLI command) ### Endpoint Not applicable (CLI command) ### Parameters None ### Request Example ```bash homechart tasks-sync ``` ### Response None specified. ``` -------------------------------- ### CalDAV Supported Methods and Endpoints Source: https://github.com/candiddev/homechart/blob/main/docs/guides/calendar.md Lists the specific WebDAV/CalDAV methods and URL patterns supported by Homechart for external client integration. ```text PROPFIND /dav/calendars PROPFIND /dav/calendars/{calendarID}/ REPORT /dav/calendars/{calendarID}/ Supported Report Sets: - calendar-query - calendar-multiget - sync-collection DELETE /dav/calendars/{calendarID}/{itemID} PUT /dav/calendars/{calendarID}/{itemID} PROPFIND /dav/principals/ PROPFIND /dav/principals/{principalID}/ ``` -------------------------------- ### Configure Homechart via JSON Source: https://context7.com/candiddev/homechart/llms.txt Application settings for Homechart, including admin access, retention policies, and SMTP server details. ```json { "app": { "adminEmailAddresses": ["admin@example.com"], "adminTrustedCIDRs": ["10.0.0.0/8", "127.0.0.1/32", "192.168.0.0/16"], "baseURL": "https://homechart.example.com", "cacheTTLMinutes": 15, "disableNotifications": false, "disableSignup": true, "disableTasks": false, "keepCalendarEventDays": 180, "keepChangeDays": 14, "keepCookMealPlanDays": 180, "keepDeletedDays": 30, "keepHealthLogDays": 180, "keepNotesPageVersions": 10, "keepPlanTasksDays": 90, "motd": "Welcome to our family Homechart!", "port": 3000, "sessionExpirationDefault": "1h", "sessionExpirationRemember": "90d", "tlsCertificate": "/etc/ssl/homechart.crt", "tlsKey": "/etc/ssl/homechart.key" }, "smtp": { "fromAddress": "homechart@example.com", "hostname": "smtp.example.com", "port": 587, "username": "homechart@example.com", "password": "smtp-password", "requireTLS": true } } ``` -------------------------------- ### Configure Web Push Notifications Source: https://context7.com/candiddev/homechart/llms.txt This JSON configuration enables web push notifications using VAPID keys. Ensure the `vapidPrivateKey` is kept secure. ```json { "webPush": { "vapidPrivateKey": "VEIYXV6qF_enUzycyQYdplDUgi05UM4lPh_FTzYmwX8" }, "app": { "baseURL": "https://homechart.example.com" } } ``` -------------------------------- ### Create Homechart PostgreSQL Database Source: https://github.com/candiddev/homechart/blob/main/docs/guides/get-homechart/self-hosted.md Use these SQL commands to create a dedicated database and user for Homechart in PostgreSQL. Ensure you replace placeholders for database name, username, and password if necessary. ```sql CREATE DATABASE homechart; CREATE ROLE "homechart" WITH CREATEDB LOGIN PASSWORD 'homechart'; REVOKE ALL PRIVILEGES ON SCHEMA public FROM public; GRANT ALL PRIVILEGES ON DATABASE homechart TO "homechart"; GRANT ALL PRIVILEGES ON SCHEMA public TO "homechart"; ``` -------------------------------- ### Generate VAPID Key Source: https://github.com/candiddev/homechart/blob/main/docs/references/config.md Commands to generate a VAPID private key for Web Push notifications using the binary or a Docker container. ```shell $ ./homechart_linux_amd64 generate-vapid VEIYXV6qF_enUzycyQYdplDUgi05UM4lPh_FTzYmwX8 ``` ```shell $ docker run -it --rm ghcr.io/candiddev/homechart generate-vapid VEIYXV6qF_enUzycyQYdplDUgi05UM4lPh_FTzYmwX8 ``` -------------------------------- ### Managing Calendars Source: https://github.com/candiddev/homechart/blob/main/docs/guides/calendar.md Homechart can display multiple calendars. Users can add, import, hide, show, or edit calendars. ```APIDOC ## Calendars Homechart can display multiple calendars. By default, you will have a Calendar for your personal and household events, Budget > Transactions, Cook > Meal Plans, and Health > Item Logs. You can add or import more Calendars by tapping **Add** > **Calendar**. Once a Calendar has been created, you can hide/show or edit it by tapping **Calendars**. To edit it, tap the edit button to the right. For iCalendar feeds, you can manually refresh the feed by tapping **Refresh**, otherwise the iCalendar feed will refresh every hour. ### Importing iCalendar Feeds Homechart can import calendars from various applications using iCalendar: - For **Google Calendar**, go under **Settings** > **Calendar Settings** for the calendar you want to import. Scroll down to the **Secret address in iCal format**, and copy the URL. In Homechart, add a calendar with this URL as the iCalendar URL. Homechart will import your Google Calendar, and periodically (every hour or so) refresh it with new changes. We recommend the following iCalendar providers for additional Calendars like weather, holidays, or religious observances: - https://weather-in-calendar.com - https://www.officeholidays.com - https://www.calendarlabs.com ``` -------------------------------- ### Event Details Source: https://github.com/candiddev/homechart/blob/main/docs/guides/calendar.md Information on how to configure event details including participants, location, travel time, recurring events, and reminders. ```APIDOC ## Events Events are things that are happening within your household. ### Participants Events can have participants, members of your household that will be at the event. When this is set, only those members will be notified of the Event, and the Event will use the [household member's colors]({{< ref "/docs/guides/settings#household" >}}). ### Location and Travel Adding a **Location** to the event will give you a handy Google Maps link for directions to the location. You can also add **Travel Time** for an event to have Homechart calculate a **Leave By** time and notify you on when you need to leave. ### Recurring Events Events can be recurring by ticking **Recurring** at the bottom. You can then set the recurring schedule. ### Reminders Events can send multiple reminders before the event starts or ends. These can be added under **Reminders**. ``` -------------------------------- ### Authelia Configuration Source: https://context7.com/candiddev/homechart/llms.txt Configuration for Authelia, an open-source authentication and access control solution. This snippet shows server settings, authentication backend, and access control policies. ```yaml server: host: 0.0.0.0 port: 9091 authentication_backend: file: path: ./users.yaml password: algorithm: argon2id iterations: 1 salt_length: 16 parallelism: 8 memory: 1024 access_control: default_policy: one_factor session: name: authelia_session domain: example.com ``` -------------------------------- ### Authelia User Configuration for Homechart Integration Source: https://context7.com/candiddev/homechart/llms.txt This YAML configuration defines users for Authelia, specifying their display name, password (hashed), email, and group memberships. These users can then be integrated with Homechart for authentication. ```yaml # authelia users.yaml users: jane@example.com: displayname: "Jane Doe" password: $argon2id$v=19$m=65536,t=1,p=8$Z2JJSk9qbVlXVk9VWUtQMw$2VqsXXhvTfiHxxvmDUj8GpzPCktmMxdLR2rojFxxknc email: jane@example.com groups: - dev john@example.com: displayname: "John Doe" password: "$argon2id$v=19$m=65536,t=1,p=8$MlplVVhMbzNmcXJmaVVsaA$ydwPNQ5wW3Lu1XuPWhQW7dzlNGP3ynexmzlQmyVMaIY" email: john@example.com groups: - dev ``` -------------------------------- ### Configure Apple OIDC Issuer Source: https://github.com/candiddev/homechart/blob/main/docs/guides/sso.md Requires a yearly Apple Developer license and specific JWT key conversion using rot pem. ```json { "oidc": { "apple": { "authURLParams": { "response_mode": "form_post" }, "clientID": "", "clientSecretJWTClaimsReg": { "aud": "https://appleid.apple.com", "exp": 12960000, "iss": "", "sub": "" }, "clientSecretJWTKey": "", "displayName": "Apple", "oidcIssuerURL": "https://appleid.apple.com", } } } ``` -------------------------------- ### Configure Microsoft OIDC Issuer Source: https://github.com/candiddev/homechart/blob/main/docs/guides/sso.md Requires an App Registration in Azure to obtain the Client ID and Client Secret. ```json { "oidc": { "microsoft": { "clientID": "", "clientSecret": "", "displayName": "Microsoft", "oidcIssuerURL": "https://login.microsoftonline.com/consumers/v2.0" } } } ``` -------------------------------- ### Configure Google OIDC Issuer Source: https://github.com/candiddev/homechart/blob/main/docs/guides/sso.md Uses a Client ID and Client Secret generated from the Google Cloud Console. ```json { "oidc": { "google": { "clientID": "", "clientSecret": "", "displayName": "Google", "oidcIssuerURL": "https://accounts.google.com" } } } ``` -------------------------------- ### Authelia User Definitions Source: https://github.com/candiddev/homechart/blob/main/docs/guides/sso.md Defines local users and their credentials for Authelia authentication. ```yaml users: jane@example.com: displayname: "Jane Doe" password: $argon2id$v=19$m=65536,t=1,p=8$Z2JJSk9qbVlXVk9VWUtQMw$2VqsXXhvTfiHxxvmDUj8GpzPCktmMxdLR2rojFxxknc email: jane@example.com groups: - dev john@example.com: displayname: "John Doe" password: "$argon2id$v=19$m=65536,t=1,p=8$MlplVVhMbzNmcXJmaVVsaA$ydwPNQ5wW3Lu1XuPWhQW7dzlNGP3ynexmzlQmyVMaIY" email: john@example.com groups: - dev ``` -------------------------------- ### Homechart CalDAV Endpoints and Configuration Source: https://context7.com/candiddev/homechart/llms.txt This section lists the CalDAV endpoints supported by Homechart for exporting calendars to external applications. It also provides configuration details for clients like Apple Calendar, DavX, and Thunderbird. ```text # CalDAV endpoints supported by Homechart PROPFIND /dav/calendars PROPFIND /dav/calendars/{calendarID}/ REPORT /dav/calendars/{calendarID}/ Supported Report Sets: - calendar-query - calendar-multiget - sync-collection DELETE /dav/calendars/{calendarID}/{itemID} PUT /dav/calendars/{calendarID}/{itemID} PROPFIND /dav/principals/ PROPFIND /dav/principals/{principalID}/ # Configure in Apple Calendar, DavX, or Mozilla Thunderbird: # URL: https://homechart.example.com/dav/calendars # Username: (generated by Homechart) # Password: (generated by Homechart) ``` -------------------------------- ### Run Homechart Maintenance Tasks Manually Source: https://context7.com/candiddev/homechart/llms.txt Manually trigger background maintenance tasks for Homechart using this command. ```bash ./homechart_linux_amd64 tasks-cleanup ``` -------------------------------- ### Traefik Dynamic Configuration for Authelia SSO Source: https://context7.com/candiddev/homechart/llms.txt This YAML configuration sets up Traefik as a reverse proxy to use Authelia for HTTP header-based SSO. It defines routers and middlewares for both Authelia and Homechart. ```yaml # traefik-dynamic.yaml http: middlewares: authelia: forwardauth: address: http://localhost:9091/api/verify?rd=https://auth.example.com:8443 authResponseHeaders: - Remote-Name - Remote-Email trustForwardHeader: true routers: authelia: service: authelia rule: "Host(`auth.example.com`)" tls: true homechart: middlewares: - authelia service: homechart rule: "Host(`homechart.example.com`)" tls: true services: authelia: loadBalancer: servers: - url: http://localhost:9091 homechart: loadBalancer: servers: - url: http://localhost:3000 ``` -------------------------------- ### Export Calendar Data Source: https://github.com/candiddev/homechart/blob/main/docs/guides/calendar.md Instructions for exporting calendar data from Homechart using ICS/iCalendar Feed and CalDAV. ```APIDOC ## Export Calendars Homechart can export your calendar for use with other calendaring applications via ICS/iCalendar Feed and CalDAV. ### Export ICS/iCalendar Feed Homechart can export an ICS/iCalendar Feed that can be imported into other applications and refreshed periodically. This method provides read-only access to your Homechart events and tasks. 1. Tap **Add > Export Calendar**. 2. Tap **Enable iCalendar**. 3. Copy the URls into your Calendar program. ### Export CalDAV Homechart can integrate with CalDAV applications to enable read/write access to your Homechart calendars. {{% alert title="CalDAV and Self-Hosting" color="info" %}} For self-hosted users, you will probably need a valid SSL/TLS certificate on your Homechart instance for this to work. {{% /alert %}} To create a CalDAV username and password for your CalDAV application: 1. Tap **Add > Export Calendar**. 2. Add a more specific CalDAV Client Name. 3. Tap **Setup CalDAV**. 4. Note the CalDAV URL, Username, and Password. Homechart has been tested and validated to work with these CalDAV clients. Are we missing one that you use or are these clients not working? Please contact us, we'll get it fixed. #### Apple Calendar 1. Open **Settings**. 2. Tap **Calendar**. 3. Tap **Add Account**. 4. Tap **Other**. 5. Add the URL, Username, and Password from Homechart. #### DavX 1. Tap **Add Account**. 2. Add the URL, Username, and Password from Homechart. #### Mozilla Thunderbird 1. Under Calendar, tap **New Calendar**. 2. Tap **On the Network**. 2. Add the URL, Username, and Password from Homechart. {{% alert title="CalDAV Conformance" color="info" %}} Homechart does not support the full WebDAV/CalDAV spec. The specific URLs/methods Homechart supports currently are: ``` PROPFIND /dav/calendars PROPFIND /dav/calendars/{calendarID}/ REPORT /dav/calendars/{calendarID}/ Supported Report Sets: - calendar-query - calendar-multiget - sync-collection DELETE /dav/calendars/{calendarID}/{itemID} PUT /dav/calendars/{calendarID}/{itemID} PROPFIND /dav/principals/ PROPFIND /dav/principals/{principalID}/ ``` {{% /alert %}} ``` -------------------------------- ### Configure Traefik Dynamic Routing Source: https://github.com/candiddev/homechart/blob/main/docs/guides/sso.md Defines the middleware and router rules for Traefik to integrate with Authelia and Homechart. ```yaml http: middlewares: authelia: forwardauth: address: http://localhost:9091/api/verify?rd=https://auth.example.com:8443 authResponseHeaders: - Remote-Name - Remote-Email trustForwardHeader: true routers: authelia: service: authelia rule: "Host(`auth.example.com`)" tls: true homechart: middlewares: - authelia service: homechart rule: "Host(`homechart.example.com`)" tls: true services: authelia: loadBalancer: servers: - url: http://localhost:9091 homechart: loadBalancer: servers: - url: http://localhost:3000 ``` -------------------------------- ### Homechart Data Retention Settings Source: https://context7.com/candiddev/homechart/llms.txt JSON configuration for Homechart's data retention policies. This allows for automatic cleanup of old calendar events, health logs, and other data based on specified day counts. ```json { "app": { "keepCalendarEventDays": 180, "keepChangeDays": 14, "keepCookMealPlanDays": 180, "keepDeletedDays": 30, "keepHealthLogDays": 180, "keepNotesPageVersions": 10, "keepPlanTasksDays": 90, "rollupBudgetMonthCategoriesMonths": 96, "rollupBudgetTransactionsBalanceMonths": 96, "rollupBudgetTransactionsSummaryMonths": 48 } } ``` -------------------------------- ### Calendar Automatic Refresh Source: https://github.com/candiddev/homechart/blob/main/docs/guides/calendar.md The Calendar screen automatically refreshes at specified intervals to keep information up-to-date. ```APIDOC ## Calendar Automatic Refresh The Calendar screen will automatically refresh, making it perfect for a tablet or kiosk. The refresh times are: - **Every minute**: Update the current time - **Every 30 minutes**: Update the current date range (e.g. if you flip to the next week, Calendar will move back to the current week automatically) ``` === COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.