[Project] OneDrive Backup Machine: Scheduled Local Backups of your OneDrive files

Share your Projects! Custom Integrations
1

Hi everyone,

I’d like to share a project I’ve been working on to solve a specific gap in many backup strategies: bringing cloud data back to local control.

While there are many tools to backup Home Assistant to the cloud, OneDrive Backup Machine does the opposite. It turns your Home Assistant host into a local backup server for your important OneDrive files/folders.

:mag: Why I built this

Most sync tools are “black boxes”—you don’t always know if a file was skipped or why a sync failed. This add-on focuses on traceability. Every backup run is stored in its own timestamped folder, making it easy to verify, browse, and recover specific versions without guessing.

:sparkles: Key Features

  • Device Login Flow: Easy linking with Microsoft account (no complex OAuth redirect setup).
  • Full & Incremental Modes: Save space by only downloading changes or grab everything for a full snapshot.
  • Task Scheduling: Create multiple tasks with different folders and cron-like schedules.
  • UI Dashboard: Built-in web interface to monitor recent jobs, counts, and detailed error logs.
  • HA Integration: Includes a Custom Component that exposes sensors (status, counts) and buttons (Run Now) directly to your Lovelace dashboard.

:hammer_and_wrench: How to Install

  1. Add my repository to your Supervisor: https://github.com/augleao/onedrive-backup-machine
  2. Install the Onedrive Backup Machine add-on.
  3. Configure your client_id (instructions in the README).
  4. (Optional) Install the custom component to get entities in your dashboard.

:camera_flash: Screenshots

image
image1088×752 74.6 KB

Check out the full documentation and source code here: :point_right: GitHub: augleao/onedrive-backup-machine

I’m actively evolving the project and would love to hear your feedback, feature requests, or help with testing!

1 Like
2

A heads up: For HomeAssistant servers that are SDCard based, this may considerably shorten the life of your SDCard if you are increasing the amount of writes on top of those needed to just run the HomeAssistant ecosystem.
To reduce the risk of loss of data due to premature failure of your SDCard, you should take robust steps to backup your data. Please do not back it up to OneDrive and create a circular runaway situation where you run out of disk space. This will become (sadly) obvious in hindsight.