Docker Loxone backup

Multi-platform Docker image for automated Loxone backups based on Alpine Linux.

Information

Service	Stats
GitHub
Docker Hub

Usage

docker pull docker.io/xjokay/loxone-backup:latest

Supported tags

Tag	Description
latest	Latest release
{release}	Specific release version, see available releases

Exposed Ports

None

Volumes

Directory	Description
/data	Location of the backups

Configuration

For this Docker image, it's strongly advised to create a separate user who has only the permission FTP.

ENV field	Req. / Opt.	Description
LOXONE_IP	Required	IP or url of the Loxone Miniserver.
LOXONE_USERNAME	Required	Loxone username.
LOXONE_PASSWORD	Required	Loxone password.
INTERVAL	Optional	Interval of backups. Default is 86400 seconds (24h). Ignored if CRON is set.
CRON	Optional	Cron expression for scheduling backups, e.g. 0 0 * * *. Overrides INTERVAL.
KEEP_DAYS	Optional	Cleanup of backups older than x days. Default is 30. Can be disabled by setting 0.
VERBOSE	Optional	If true, increases the verbosity level. Default is false.
EXCLUDE_DIRS	Optional	Comma separated list of folders to exclude, e.g. dir1,dir2. Default is excluding nothing.

Samples

docker-compose

services:
  app:
    image: docker.io/xjokay/loxone-backup:latest
    volumes:
      - ./data:/data
    environment:
      - TZ=Europe/Zurich
      - LOXONE_IP=192.168.1.10
      - LOXONE_USERNAME={loxone-username}
      - LOXONE_PASSWORD={loxone-password}
    networks:
      - default

docker run

docker run -d \
  -v $PWD/data:/data \
  -e TZ=Europe/Zurich \
  -e LOXONE_IP=192.168.1.10 \
  -e LOXONE_USERNAME={loxone-username} \
  -e LOXONE_PASSWORD={loxone-password} \
  docker.io/xjokay/loxone-backup:latest