1
0
Fork 0
mirror of https://github.com/borgbase/vykar.git synced 2026-04-15 02:04:06 -07:00
Fast, encrypted, deduplicated backups in Rust — with friendly YAML config, a desktop GUI, and support for S3, custom REST and SFTP storage. https://vykar.borgbase.com
  • Rust 87.5%
  • Python 8.6%
  • Shell 2%
  • Slint 1.4%
  • Nix 0.4%
Find a file
Manu ee8b036d67 feat(gui): add AppImage packaging for Linux
Bundle shared libraries (libxdo, GTK3, etc.) into a self-contained
AppImage using linuxdeploy, so the prebuilt binary no longer depends
on the host distro's library versions.

- Add .desktop file and build script (scripts/build-appimage.sh)
- Add build-appimage CI job that reuses the build-linux artifact
- CI verifies AppDir contract and library bundling before upload
- Update Linux install docs to recommend AppImage with FUSE fallback

Closes #91
2026-04-15 16:45:45 +08:00
.agents fix(backup): make vykar-dumps visible and guard against path collisions 2026-03-17 13:53:58 +00:00
.cargo fix(windows): statically link MSVC C runtime to avoid missing DLL errors 2026-03-24 06:43:16 +00:00
.github/workflows feat(gui): add AppImage packaging for Linux 2026-04-15 16:45:45 +08:00
.nix feat(nix): add Nix flake packaging. By @Sntx626 (#96) 2026-04-09 14:16:26 +01:00
crates feat(gui): add AppImage packaging for Linux 2026-04-15 16:45:45 +08:00
docs feat(gui): add AppImage packaging for Linux 2026-04-15 16:45:45 +08:00
fuzz feat: add coverage-guided fuzz tests for parser and crypto paths 2026-03-10 08:22:51 +00:00
scripts feat(gui): add AppImage packaging for Linux 2026-04-15 16:45:45 +08:00
.claude meta: reorganize skills folders 2026-02-20 15:06:21 +00:00
.gitignore feat(nix): add Nix flake packaging. By @Sntx626 (#96) 2026-04-09 14:16:26 +01:00
AGENTS.md docs: radically simplify AGENTS.md (191 → 32 lines) 2026-03-07 21:25:47 +00:00
Cargo.lock refactor: deduplicate code and fix anti-patterns across workspace 2026-04-14 13:09:22 +08:00
Cargo.toml refactor: extract shared utilities into vykar-common crate 2026-04-14 12:25:24 +08:00
CLAUDE.md meta: reorganize skills folders 2026-02-20 15:06:21 +00:00
CONTRIBUTING.md feat(nix): add Nix flake packaging. By @Sntx626 (#96) 2026-04-09 14:16:26 +01:00
Dockerfile feat: add curl, jq, and bash to Docker image for hook support 2026-03-12 21:46:59 +00:00
Dockerfile.apprise feat(docker): add apprise variant image for hook notifications 2026-03-15 07:10:52 +00:00
flake.lock feat(nix): add Nix flake packaging. By @Sntx626 (#96) 2026-04-09 14:16:26 +01:00
flake.nix feat(nix): add Nix flake packaging. By @Sntx626 (#96) 2026-04-09 14:16:26 +01:00
LICENSE Change license to match Slint UI 2026-02-12 19:27:22 +00:00
Makefile feat(gui): add AppImage packaging for Linux 2026-04-15 16:45:45 +08:00
prek.toml chore: add prek pre-commit hooks 2026-03-15 13:33:07 +00:00
README.md feat: add Docker image published to GHCR on release 2026-03-09 20:29:32 +00:00
shell.nix feat(nix): add Nix flake packaging. By @Sntx626 (#96) 2026-04-09 14:16:26 +01:00
testing.md Update e2e test guidance and REST defaults 2026-03-06 22:49:46 +00:00
vykar.example.yaml docs: add Windows path quoting examples to config docs and templates 2026-03-23 21:46:49 +00:00

Vykar Backup

A fast, encrypted, deduplicated backup tool written in Rust centered around a friendly YAML config file.

Inspired by BorgBackup, Borgmatic, Restic, and Rustic. Vykar uses its own on-disk format and is not compatible with Borg or Restic repositories.

⚠️ Don't use for production backups yet, but do test it along other backup tools.

Features

  • Storage backends — local filesystem, S3 (any compatible provider), SFTP, dedicated REST server
  • Encryption with AES-256-GCM or ChaCha20-Poly1305 (auto-selected) and Argon2id key derivation
  • YAML-based configuration with multiple repositories, hooks, and command dumps for monitoring and database backups
  • Deduplication via FastCDC content-defined chunking with a memory-optimized engine (tiered dedup index + mmap-backed pack assembly)
  • Compression with LZ4 or Zstandard
  • Built-in WebDAV and desktop GUI to browse and restore snapshots
  • REST server with append-only enforcement, quotas, and server-side compaction
  • Concurrent multi-client backups — multiple machines back up to the same repository simultaneously; only the brief commit phase is serialized
  • Built-in scheduling via vykar daemon — runs backup cycles on a configurable interval (no cron needed)
  • Resource limits for worker threads, backend connections, and upload/download bandwidth
  • Cross-platform — Linux, macOS, and Windows

Benchmarks

Vykar leads in both speed and CPU efficiency, while maintaining competitive memory usage.

Backup Tool Benchmark

All benchmarks were run on the same idle Intel i7-6700 CPU @ 3.40GHz machine with 2x Samsung PM981 NVMe drives. Compression settings were chosen to keep resulting repository sizes comparable. The sample corpus is a mix of small and large files with varying compressibility. See our benchmark script for full details.

Quick start

curl -fsSL https://vykar.borgbase.com/install.sh | sh

Or download the latest release for your platform from the releases page. A Docker image is also available.

# Generate a starter config and edit it
vykar config

# Initialize the repository and run a backup
vykar init
vykar backup

# List snapshots
vykar list

See the full documentation for storage backends, restore, maintenance, and more.

Desktop UI

Vykar GUI

vykar-gui is a Slint-based desktop app that uses vykar-core directly (it does not shell out to the CLI).

  • Run backups on demand
  • List snapshots and browse snapshot contents
  • Extract snapshot contents
  • Run in the system tray with periodic background backups
  • Uses vykar.yaml as the source of truth and auto-reloads config changes

Periodic GUI scheduling is configured in vykar.yaml via:

schedule:
  enabled: true
  every: "24h"
  on_startup: false
  jitter_seconds: 0
  passphrase_prompt_timeout_seconds: 300

Security

To report a security vulnerability, please email hello@borgbase.com.

License

GNU General Public License v3.0