include backup functionality
This commit is contained in:
@@ -213,10 +213,25 @@ configure
|
||||
It covers:
|
||||
|
||||
- **Your Federated Computer Core.** Give it your Superpanel's address (e.g. https://superpanel.example.com), your Core email, name and password, and it adds Superpanel to your applications, joins this computer to your Core's Tailscale network, adds your Nextcloud (calendar, contacts and files) and email to GNOME's Online Accounts, and mounts your Nextcloud files at /mnt/example.com ("example.com" in the Files sidebar), and points Element at your Core's Matrix server. For Nextcloud and the files it creates a Nextcloud app password, which you can revoke in Nextcloud under Settings > Security.
|
||||
- **Daily backups of your home folder** to your Nextcloud files, in /mnt/example.com/.backup-{machine name}, with borg. Set up your Core first. The backup is encrypted with a passphrase that `configure` shows you once: save it somewhere other than this computer, such as Bitwarden. It keeps 7 daily, 4 weekly and 6 monthly backups, and leaves out caches and things that can be reinstalled. To leave out more, list paths in ~/.config/coredesktop/backup-exclude, one per line. See "Restoring from a backup" below.
|
||||
- Signing in to Claude Code, opencode and Hermes Agent and choosing their model providers.
|
||||
|
||||
To set up one thing, name it, e.g. `configure hermes`; `configure --list` shows the names.
|
||||
|
||||
### Restoring from a backup
|
||||
|
||||
To see the backups and get files back:
|
||||
|
||||
```
|
||||
export BORG_REPO=/mnt/example.com/.backup-$HOSTNAME
|
||||
export BORG_PASSCOMMAND="secret-tool lookup coredesktop backup repo $BORG_REPO"
|
||||
borg list
|
||||
mkdir ~/restored && cd ~/restored
|
||||
borg extract ::{backup name} home/{you}/Documents
|
||||
```
|
||||
|
||||
On a new computer, set up your Core with `configure core` first. Then point `BORG_REPO` at the old computer's .backup-{name} folder and leave out `BORG_PASSCOMMAND`: borg asks for the passphrase you saved. `systemctl --user list-timers coredesktop-backup.timer` shows when the next backup runs, and `journalctl --user -u coredesktop-backup` shows how the last ones went.
|
||||
|
||||
## Sandboxed AI agents
|
||||
|
||||
CoreDesktop installs the AI coding agents opencode, Hermes Agent and Claude Code, and runs them in a sandbox. In the sandbox, an agent:
|
||||
|
||||
Reference in New Issue
Block a user