explaingit

ashishdevasia/ha-proton-drive-backup

Analysis updated 2026-05-18

6PythonAudience · ops devopsComplexity · 2/5LicenseSetup · moderate

TLDR

A Home Assistant add-on that automatically backs up your smart home data to Proton Drive on a schedule, with the same generational retention logic as the popular Google Drive Backup add-on.

Mindmap

mindmap
  root((HA Proton Backup))
    What it does
      Auto backups to Proton Drive
      Scheduled and generational
      End-to-end encrypted
    How it works
      Bundles proton-drive CLI
      Browser login not OAuth
      Metadata sidecar files
    Installation
      Add repo to HA store
      Install and start
      Sign in to Proton
    Limitations
      aarch64 and amd64 only
      No official Proton API
      Unofficial project
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Automatically back up your Home Assistant instance to end-to-end encrypted Proton Drive on a daily schedule.

USE CASE 2

Replace a Google Drive backup setup with a privacy-focused Proton Drive alternative without reconfiguring the backup schedule.

USE CASE 3

Keep generational backups so recent copies are retained in full while older ones thin out automatically.

What is it built with?

PythonHome AssistantDocker

How does it compare?

ashishdevasia/ha-proton-drive-backupbro77xp/beginner-friendly-ai-vtuberda7-tech/mind
Stars666
LanguagePythonPythonPython
Setup difficultymoderatehardeasy
Complexity2/53/52/5
Audienceops devopsgeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires a Proton Drive account and Home Assistant running on aarch64 or amd64 hardware.

Use, modify, and distribute freely for any purpose, including commercial use, as long as you keep the copyright notice (MIT).

In plain English

This is a Home Assistant add-on that automatically backs up your Home Assistant instance to Proton Drive. Proton Drive is an end-to-end encrypted cloud storage service from Proton, the company behind ProtonMail. If you already use Home Assistant to manage smart home devices and want your backups stored in a privacy-focused cloud rather than Google Drive, this add-on handles that. The add-on is a port of the well-known Home Assistant Google Drive Backup add-on. The scheduling, retention, and generational backup logic is carried over unchanged. Generational backup means you keep more recent backups and fewer older ones automatically, so you do not have to manage retention by hand. Only the storage destination has been changed from Google Drive to Proton Drive. Because Proton Drive has no public API, the add-on uses Proton's official command-line tool, which it bundles inside. Authentication is done through an interactive browser login rather than an automated flow. Each backup also saves a small metadata file alongside the backup archive in Proton Drive, since there is no API for storing file properties directly. Installation takes about four steps: add the repository URL to your Home Assistant add-on store, install the add-on, start it, and sign in to your Proton account through the web interface the add-on provides. It supports aarch64 and amd64 hardware, which covers most Home Assistant setups including standard Raspberry Pi devices and x86 machines. The project is unofficial and not affiliated with Proton AG. It is licensed under MIT.

Copy-paste prompts

Prompt 1
I've installed ha-proton-drive-backup. Walk me through setting up a schedule that keeps 3 daily, 2 weekly, and 1 monthly backup in Proton Drive.
Prompt 2
I'm getting authentication errors in ha-proton-drive-backup after my Proton password changed. How do I re-authenticate from the add-on web UI?
Prompt 3
How does the generational backup feature decide which copies to keep or delete? Help me configure a 30-day retention policy.
Prompt 4
I want to migrate my existing Home Assistant backups from Google Drive to Proton Drive. What steps should I follow to switch add-ons without losing backups?

Frequently asked questions

What is ha-proton-drive-backup?

A Home Assistant add-on that automatically backs up your smart home data to Proton Drive on a schedule, with the same generational retention logic as the popular Google Drive Backup add-on.

What language is ha-proton-drive-backup written in?

Mainly Python. The stack also includes Python, Home Assistant, Docker.

What license does ha-proton-drive-backup use?

Use, modify, and distribute freely for any purpose, including commercial use, as long as you keep the copyright notice (MIT).

How hard is ha-proton-drive-backup to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is ha-proton-drive-backup for?

Mainly ops devops.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub ashishdevasia on gitmyhub

Verify against the repo before relying on details.