backup-to-nextcloud

A simple application that will backup files to Nextcloud.

Designed to be run as a CronJob with a focus on directories containing backup archives (e.g. daily zip files).

Features

• Define jobs via yaml config
• Optionally clean up files on Nextcloud older than a given age
• Optionally only store the latest X number of files

Usage

Example Config

nextcloudURL: https://nextcloud.example.com
jobs:
  - sourceDirectory: backups/example-daily
    destinationDirectory: backups/example
    # Optional
    maxAge: 168h # 7 days
    # Optional
    maxItems: 7

By default, this loads from ./config.yaml but the file path can be specified by setting the NEXTCLOUD_CONFIG_PATH environment variable.

Credentials

Generate an app password for your user in Nextcloud then populate the following environment variables:

• NEXTCLOUD_USER
• NEXTCLOUD_PASSWORD

Example Kubernetes CronJob

apiVersion: batch/v1
kind: CronJob
metadata:
  name: backup-to-nextcloud
  labels:
    app.kubernetes.io/name: backup-to-nextcloud
spec:
  schedule: "30 11 * * *" # Run every day at 11:30 AM
  jobTemplate:
    metadata:
      labels:
        cronjob: backup-to-nextcloud
    spec:
      template:
        spec:
          containers:
          - name: backup
            image: rg.fr-par.scw.cloud/averagemarcus/backup-to-nextcloud:latest
            imagePullPolicy: IfNotPresent
            env:
              - name: NEXTCLOUD_CONFIG_PATH
                value: /config/config.yaml
            envFrom:
              - secretRef:
                  name: backup-to-nextcloud-credentials
            volumeMounts:
            - mountPath: /backup
              name: backup-source
            - mountPath: /config
              name: config
          restartPolicy: OnFailure
          volumes:
          - name: backup-source
            persistentVolumeClaim:
              claimName: source-to-backup
          - name: config
            configMap:
              name: backup-to-nextcloud-jobs
---
apiVersion: v1
kind: ConfigMap
metadata:
  name: backup-to-nextcloud-jobs
data:
  config.yaml: |
    nextcloudURL: https://nextcloud.example.com
    jobs:
      - sourceDirectory: /backup/app1
        destinationDirectory: /backup/app1
        maxAge: 168h
        maxItems: 7
---
apiVersion: v1
kind: Secret
metadata:
  name: backup-to-nextcloud-credentials
stringData:
  NEXTCLOUD_USER: XXXX
  NEXTCLOUD_PASSWORD: XXXX

Building from source

With Docker:

make docker-build

Standalone:

make build

Resources

• Nextcloud WebDav docs

Contributing

If you find a bug or have an idea for a new feature please raise an issue to discuss it.

Pull requests are welcomed but please try and follow similar code style as the rest of the project and ensure all tests and code checkers are passing.

Thank you 💛

License

See LICENSE