# Owncloud Backup Homeassistant by René Bachmann

Home Assistant custom integration that adds **ownCloud (Classic/Server)** as a **Backup Location / Backup Agent** using the official **WebDAV** interface.

This integration allows you to:
- store Home Assistant backups in ownCloud via WebDAV
- list backups stored in ownCloud from within the Home Assistant UI
- download and **restore** backups via the Home Assistant UI
- authenticate using **either** an ownCloud **App Password** (recommended for 2FA) **or** the regular account password

> **Status:** `0.1.0-alpha`  
> This is an early alpha release. Please test on a non-critical system first.

---

## Features

- ✅ Home Assistant **Backup Agent** implementation (Backup Location)
- ✅ **Upload** backups to ownCloud via WebDAV
- ✅ **List** backups from ownCloud in HA UI
- ✅ **Download / Restore** backups via HA UI (streaming download)
- ✅ **Delete** backups from ownCloud
- ✅ Automatic DAV endpoint detection for ownCloud Classic:
  - `/remote.php/dav/files/<user>/`
  - `/remote.php/webdav/`
- ✅ Metadata sidecar (`.json`) for reliable listing + fallback when metadata is missing
- ✅ Supports **App Password** and **standard login**
- ✅ English UI & documentation
- ✅ HACS-ready repository structure

---

## Requirements

- Home Assistant version that supports the modern Backup system with backup agents (2025.x+).
- ownCloud Classic / Server with WebDAV enabled (default in ownCloud).

---

## Installation (HACS)

### Add as a custom repository
1. In Home Assistant: **HACS → Integrations → ⋮ → Custom repositories**
2. Add your repository URL
3. Category: **Integration**
4. Install **owncloud-backup-ha**
5. Restart Home Assistant

> This repository includes a `hacs.json` and follows the required `custom_components/` layout.

---

## Installation (Manual)

1. Copy the folder `custom_components/owncloud_backup/` into your Home Assistant config directory:
   - `<config>/custom_components/owncloud_backup/`
2. Restart Home Assistant.

---

## Configuration

1. In Home Assistant, go to:
   - **Settings → Devices & services → Add integration**
2. Search for:
   - **ownCloud Backup (WebDAV)**
3. Enter:
   - **Base URL** (example: `https://cloud.example.com`)
   - **Username**
   - **Password / App Password**
   - **Backup folder path** (default: `/HomeAssistant/Backups`)
   - **Verify SSL** (default: enabled)

### Recommended authentication
- If you use **2FA**, create an **App Password** and use it as the "Password" field.
- If you do **not** use 2FA, your standard login password should also work.

---

## How backups are stored in ownCloud

The integration uploads:
- the backup tarball: `ha_backup_<backup_id>.tar`
- a metadata file: `ha_backup_<backup_id>.json`

The JSON metadata enables reliable listing and display in the HA UI.

If the JSON metadata is missing (e.g., you manually copied a `.tar`), the integration will still try to show the backup using WebDAV file properties (size + last modified time) as a fallback.

---

## Restore workflow (UI)

1. **Settings → System → Backups**
2. Select a backup from the ownCloud location
3. Choose **Restore**

Home Assistant will download the `.tar` from ownCloud using the Backup Agent API (streaming).

---

## Troubleshooting

### "Cannot connect"
- Check your **Base URL**
- Make sure the ownCloud user can access WebDAV
- If you use 2FA, try an **App Password**
- Verify that your reverse proxy does not block `PROPFIND`, `MKCOL`, or `DELETE`

### SSL / certificate issues
- If you use a self-signed certificate, either:
  - install the CA properly, or
  - temporarily disable **Verify SSL** (not recommended for production)

### Missing backups in list
- Ensure the configured backup folder is correct
- Check that ownCloud contains either:
  - `.json` metadata files (preferred), or
  - `.tar` files (fallback)

---

## Security notes

- Credentials are stored in Home Assistant config entry storage.
- Prefer **App Passwords** over your main login password, especially with 2FA enabled.

---

## Development notes

This integration intentionally does not depend on external Python packages to keep deployment simple.