https://github.com/karanhudia/borg-ui
Replace complex Borg Backup terminal commands with a beautiful web UI. Create, schedule, and restore backups with just a few clicks.
https://github.com/karanhudia/borg-ui
automation back borg borg-backup borgbackup borgbase deduplication docker raspber sbc self-hosted webapp
Last synced: 18 days ago
JSON representation
Replace complex Borg Backup terminal commands with a beautiful web UI. Create, schedule, and restore backups with just a few clicks.
- Host: GitHub
- URL: https://github.com/karanhudia/borg-ui
- Owner: karanhudia
- License: gpl-3.0
- Created: 2025-08-11T05:32:22.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2026-01-27T20:06:25.000Z (about 2 months ago)
- Last Synced: 2026-01-27T21:08:46.464Z (about 2 months ago)
- Topics: automation, back, borg, borg-backup, borgbackup, borgbase, deduplication, docker, raspber, sbc, self-hosted, webapp
- Language: Python
- Homepage: https://karanhudia.github.io/borg-ui/
- Size: 5.43 MB
- Stars: 933
- Watchers: 0
- Forks: 19
- Open Issues: 44
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Security: docs/security.md
Awesome Lists containing this project
README
---
[](https://hub.docker.com/r/ainullcode/borg-ui)
[](LICENSE)
[](https://github.com/karanhudia/borg-ui/actions)
[](https://github.com/karanhudia/borg-ui/actions/workflows/tests.yml)
[](https://codecov.io/gh/karanhudia/borg-ui)
[](https://discord.gg/5KfVa5QkdQ)
A modern web interface for Borg Backup
Zero-configuration deployment - just run and go.
---
> [!NOTE]
> This project uses [Claude Code](https://claude.ai/code) as a development assistant. I'm a full-stack developer with 10+ years of experience, and I personally review all AI-generated code before merging. Architecture decisions, security practices, and testing are human-driven. Claude Code is acknowledged as a co-author in git commits. All code is open source for community review - your backups deserve scrutiny, and I encourage it.
---
## Features & Screenshots
### Modern Dashboard
Monitor all your repositories, backup status, and system metrics at a glance. View repository health, recent activity feed, storage usage, and quick access to common operations. Get a comprehensive overview of your entire backup infrastructure in one place.
---
### Live Backup Progress
Watch your backups execute in real-time with detailed progress tracking. Monitor current file being processed, backup speed (MB/s), data statistics (original, compressed, deduplicated sizes), estimated time remaining, and overall completion percentage.
---
### Repository Management
Create and manage repositories with support for local storage, SSH, and SFTP connections. Configure encryption (repokey, keyfile), compression algorithms (lz4, zstd, zlib, lzma, auto, obfuscate), source directories, exclude patterns, and custom borg flags. Import existing repositories or create new ones with step-by-step wizard.
---
### Smart Notifications
Get instant alerts for backup events via 100+ notification services powered by Apprise. Configure Email, Slack, Discord, Telegram, Pushover, Microsoft Teams, and many more. Set up per-repository notification preferences with customizable templates for backup start, success, failure, and warnings.
---
### Archive Browsing
Browse and restore files from any backup archive with 600x faster performance using Redis caching. Navigate through your backup history, preview file contents, and restore individual files or entire directories.
---
### Schedule Management
Create and manage automated backup schedules with visual cron builder. Configure multi-repository backups, set up pre/post scripts, enable automatic pruning and compacting, and track execution history with detailed logs.
---
## Key Features
- **Backup Management** - Create, schedule, and monitor backups with live progress tracking
- **Archive Browser** - Browse and restore files from any backup archive with Redis caching (600x faster for large repos)
- **Repository Management** - Support for local, SSH, and SFTP repositories with multiple compression options
- **Scheduling** - Visual cron job builder with execution history
- **Pre/Post Backup Hooks** - Run custom scripts before/after backups (e.g., stop Docker containers, database dumps)
- **Notifications** - Get alerts via 100+ services (Email, Slack, Discord, Telegram, Pushover, etc.)
- **SSH Key Management** - Generate, import, and deploy SSH keys for remote repositories
- **Real-time Monitoring** - Live backup progress, system metrics, and health checks
- **Multi-platform** - Supports amd64, arm64, and armv7 architectures
---
## Getting Started
**Installation is simple with Docker:**
```bash
# Pull and run
docker run -d \
--name borg-web-ui \
-p 8081:8081 \
-v borg_data:/data \
-v borg_cache:/home/borg/.cache/borg \
-v /home/yourusername:/local:rw \
ainullcode/borg-ui:latest
```
Access at `http://localhost:8081` • Default credentials: `admin` / `admin123`
**📖 [Installation Guide](https://karanhudia.github.io/borg-ui/installation)** - Complete setup with Docker Compose, Redis, Portainer, Unraid
---
## Documentation
**[📚 Full Documentation](https://karanhudia.github.io/borg-ui)** - Complete guides and tutorials
Quick links:
- [Installation Guide](https://karanhudia.github.io/borg-ui/installation) - Detailed setup for all platforms
- [Configuration Guide](https://karanhudia.github.io/borg-ui/configuration) - Environment variables and customization
- [Usage Guide](https://karanhudia.github.io/borg-ui/usage-guide) - Creating your first backup
- [Notifications Setup](https://karanhudia.github.io/borg-ui/notifications) - Email, Slack, Discord alerts
- [SSH Keys Guide](https://karanhudia.github.io/borg-ui/ssh-keys) - Remote backup setup
- [Security Guide](https://karanhudia.github.io/borg-ui/security) - Best practices
---
## Support
- **Discord**: [Join our community](https://discord.gg/5KfVa5QkdQ) - Get help, share your setup, suggest features
- **Documentation**: [Full Documentation](https://karanhudia.github.io/borg-ui)
- **Bug Reports**: [GitHub Issues](https://github.com/karanhudia/borg-ui/issues)
- **Discussions**: [GitHub Discussions](https://github.com/karanhudia/borg-ui/discussions)
---
## Contributing
Want to help improve Borg Web UI? See our [Contributing Guide](.github/CONTRIBUTING.md) and [Development Guide](https://karanhudia.github.io/borg-ui/development) to get started.
---
## License
This project is licensed under the GNU Affero General Public License v3.0 - see the [LICENSE](LICENSE) file for details.
---
Built with [Borg Backup](https://borgbackup.readthedocs.io/), [FastAPI](https://fastapi.tiangolo.com/), [React](https://react.dev/), and [Material-UI](https://mui.com/)
Made with ❤️ by [Karan Hudia](https://github.com/karanhudia)