Caution
Do not install this release - use v0.12.1 instead.
On SQLite, the server can fail to start after upgrading with Dirty database version 43. It happens when the database holds deliveries of deleted notifications, and it leaves the database half migrated. If this happened to you, upgrade to v0.12.1: it repairs the database on start. No manual steps are needed.
If v0.12.0 started fine, upgrade anyway. v0.12.1 also fixes foreign keys that could stop being enforced on SQLite. It also stops the server from printing ARKEEP_SECRET_KEY and ARKEEP_AGENT_SECRET in its output when it stops on an error. If v0.12.0 stopped on an error, restrict access to those logs or clear them.
Important
Upgrade in this order - see Upgrading:
- Back up the database (or the
data/volume): migrations run automatically when the server starts. - Upgrade the server and check that
/health/readyreportshealthy. - Then upgrade the agents. An agent refuses to enroll with a server older than itself.
๐ฆ Install
docker pull arkeepio/arkeep-server:v0.12.0
docker pull arkeepio/arkeep-agent:v0.12.0Kubernetes: helm install arkeep oci://ghcr.io/arkeep-io/charts/arkeep --version 0.12.0 (also oci://registry-1.docker.io/arkeepio/arkeep).
Images are published on Docker Hub for linux/amd64 and linux/arm64, and also on GitHub Container Registry (ghcr.io/arkeep-io/arkeep-server, ghcr.io/arkeep-io/arkeep-agent). Standalone binaries โ server for Linux and macOS, agent for Linux (amd64, arm64, armv7, mips, mipsle), macOS and Windows โ are attached below. See the installation docs for Docker Compose, binary and Helm setups.
Changelog
๐ Features
- feat(deploy): add a Home Assistant app for the agent (a220cb7) by @TheGuit
- feat(gui): confirm before leaving a settings page with unsaved changes, and save settings from an unsaved-changes bar (eb6e42b, 2957f6b) by @Fcrotti1
- feat(gui): sort notification providers and group the notifications page into events and channels (71ccf21) by @Fcrotti1
- feat(notification): send agent status, password reset and SMTP test as HTML email (6252033) by @airfryer-nugget
- feat(release): publish the agent as .deb and .rpm packages in an APT and RPM repository #472 (e7a7d35, 78deec9) by @Fcrotti1
- feat: add notification providers for push and chat services #446 (2bd2aaf) by @Fcrotti1
- feat: link agent status emails to the agent's page (1f3340a) by @Fcrotti1
- feat: record and show the restic summary of each snapshot #470 (8922e89) by @Fcrotti1
๐ Bug Fixes
- fix(agent): keep the snapshot of a backup that restic ends with exit code 3 (8451ec5) by @Fcrotti1
- fix(agent): restore only into a folder no other local user controls (e728e75, 7198f09) by @Fcrotti1
- fix(api): do not send stored secrets to a new host (972d77c) by @Fcrotti1
- fix(auth): rate limit IPv6 clients per /64 and count second-factor codes per account (9dad1f4) by @Fcrotti1
- fix(enroll): authenticate agent enrollment with the agent secret without sending it (d9f2b5c) by @Fcrotti1
- fix: read rclone.conf from a fixed path in the agent image #463 (b445d1c) by @Fcrotti1
๐๏ธ Build & CI
- ci: publish the Home Assistant app on stable releases (0aeb0c1, 46ef079) by @TheGuit
- fix(release): build the GUI in a job without secrets and keep the signing key on disk only while it signs (6e67780) by @Fcrotti1
- fix(release): publish the Home Assistant app and GHCR only from the release environment (b39bae0) by @Fcrotti1
- ci: read the personal access tokens from the automation environment (e07e1a7) by @Fcrotti1
๐งน Maintenance
๐ Verify
Every archive, both images and the Helm chart carry a build provenance attestation from the release workflow run of this tag, checked with the GitHub CLI:
sha256sum --check --ignore-missing checksums.txt
gh attestation verify arkeep-server_linux_amd64.tar.gz --repo arkeep-io/arkeep --signer-workflow arkeep-io/arkeep/.github/workflows/release.yml --source-ref refs/tags/v0.12.0
gh attestation verify oci://ghcr.io/arkeep-io/arkeep-server:v0.12.0 --repo arkeep-io/arkeep --signer-workflow arkeep-io/arkeep/.github/workflows/release.yml --source-ref refs/tags/v0.12.0Full Changelog: v0.11.1...v0.12.0