Skip to content

Latest commit

 

History

History
45 lines (33 loc) · 1.98 KB

readme.md

File metadata and controls

45 lines (33 loc) · 1.98 KB

HomeMatic CCU Auto-Backup

This is a small script which periodically (at the moment: daily) fetches a backup of your CCU Device and uploads it into a S3 Storage (for example: Minio) If the S3 upload fails, it will be saved into a local directory (currently the working directory, /app)

Config

ENV Description Required/Default
MINIO_HOST S3 Endpoint of your storage server required
MINIO_BUCKET S3 Bucket to save into required
MINIO_ACCESS_KEY S3 Access Key with write permissions into the given bucket required
MINIO_SECRET_KEY S3 Secret key correspoding to the access key required
HOMEMATIC_USERNAME Homematic User with backup permission (probably an Admin user) required
HOMEMATIC_PASSWORD corresponding password required
HOMEMATIC_HOST URL / Host to access the CCU Device required

Or simply copy the .env.example file to .env and edit the values.

Usage

Simple docker run: docker run --env-file .env -d --name ccu3-backup n404/ccu3-backup

Docker Compose Version:

version: "3.6"
services:
  ccu3-backup:
    image: n404/ccu3-backup
    container_name: ccu3-backup
    restart: unless-stopped
    env_file:
      - .env

Todo (Contributions are welcome)

  • todo: before start: check for all necessary env variables (username hostname access token etc.)
  • add an env variable for disabling S3 and use local storage by default
  • add a useful logging library for displaying better time data in console logs
  • add a config for the time schedule, when to back up

© 2023 Trickfilm400