Changelog โ
All notable changes to DBackup are documented here.
v1.0.1 - Hotfix Release & API Documentation โ
Released: March 14, 2026
๐ Bug Fixes โ
- ui: Mouse wheel now works in all
CommandList-based dropdowns (Radix ScrollArea bypass) - MSSQL: Backup failures now include actual SQL Server error messages instead of only "terminating abnormally"
- performance: Resolved multiple patterns causing app hangs โ parallel health checks with 15s timeout, async MySQL CLI detection, async file I/O, adaptive history polling
๐ง CI/CD โ
- pipeline: Added
validatestage running lint, type-check, and tests in parallel before Docker builds - pipeline: Split single
docker buildxinto parallel amd64/arm64 jobs, combined viaimagetools create - Docker Hub: Automatically pushes README to Docker Hub on release with absolute image URLs
๐ Documentation โ
- API: Full OpenAPI 3.1 spec with interactive Scalar reference at
/docs/apiand api.dbackup.app - user guide: Getting Started rewritten and expanded into multi-page User Guide (Getting Started, First Steps, First Backup)
- README: Revised feature list, added Community & Support section with Discord, GitLab Issues, and contact emails
๐ณ Docker โ
- Image:
skyfay/dbackup:v1.0.1 - Also tagged as:
latest,v1 - Platforms: linux/amd64, linux/arm64
v1.0.0 - First Stable Release โ
Released: March 10, 2026
๐ DBackup 1.0.0 โ the first stable release. Stabilizes the platform after the beta phase with quality-of-life fixes, stale execution recovery, update notifications, and dashboard polish.
โ ๏ธ Breaking: All Prisma migrations squashed into a single
0_initmigration. Existing beta databases are not compatible. Export your config via Settings โ Config Backup before upgrading, then re-import afternpx prisma migrate deploy.
โจ Features โ
- sessions: Configurable session lifetime (1hโ90d), sessions tab in profile with browser/OS icons, revoke individual or all other sessions
- backup: Stale execution recovery โ on startup, detects executions stuck in
Running/Pendingand marks them asFailed - notifications: Update notifications when a new version is detected, with deduplication and configurable reminder intervals (default: 7 days)
- notifications: Storage alerts and update notifications support repeat intervals (Disabled / 6h / 12h / 24h / 2d / 7d / 14d)
- jobs: Multi-destination fan-out โ upload to unlimited storage destinations per job with per-destination retention policies and
Partialstatus - jobs: Database selection moved from Source config to Job form with multi-select
DatabasePicker - config backup: Enhanced import with statistics toggle, smart encryption recovery, name-based deduplication, and FK remapping
- validation: Sources, Jobs, Encryption Profiles, and Groups enforce unique names with HTTP 409 and descriptive toasts
๐ Security โ
- auth: Fixed middleware matcher to correctly apply rate limiting to authentication endpoints
- adapters: Strict Zod schemas reject shell metacharacters in adapter config fields (command injection prevention)
- MSSQL: Database name identifiers now properly escaped with bracket notation (SQL injection prevention)
- SSO:
clientIdandclientSecretencrypted at rest with AES-256-GCM
๐จ Improvements โ
- scheduler: New dual-mode schedule picker with Simple Mode (frequency pills + dropdowns) and Cron Mode with human-readable descriptions
- jobs: Form restructured into 4 tabs (General, Destinations, Security, Notify) with database picker and inline retention
- ui: Replaced orange pulsing update indicator with muted blue styling
๐ Bug Fixes โ
- Redis: Replaced incorrect multi-select database picker with 0โ15 dropdown
- ui: Fixed database icon showing red instead of yellow for
Pendingexecutions - API: Bash trigger script checks
success: truebefore parsing; documentedhistory:readrequirement - auth: Split rate limit module into Edge-safe and server-only to avoid
node:cryptoimport in Edge Runtime - config backup: Fixed 7 issues including missing Zod field, download crash, meta format detection, and FK violations
๐ณ Docker โ
- Image:
skyfay/dbackup:v1.0.0 - Also tagged as:
latest,v1 - Platforms: linux/amd64, linux/arm64
v0.9.9-beta - Storage Alerts, Notification Logs & Restore Improvements โ
Released: February 22, 2026
โจ Features โ
- restore: Backup compatibility matrix โ pre-restore version check with green/orange/red banners and MSSQL edition guard
- MSSQL: SSH test button โ tests SSH connectivity, backup path access, and write permissions
- restore: Dedicated restore page with 2-column layout, file details, database mapping, privileged auth, and version checks
- storage: Explorer with tabs (Explorer, History, Settings), side-by-side charts, and trend indicators
- storage: Three alert types (Usage Spike, Storage Limit, Missing Backup) with per-destination config and notification integration
- settings: Data retention settings โ separate retention periods for Audit Logs and Storage Snapshots (7dโ5y)
- notifications: Notification log history with adapter-specific previews (Discord, Email, Slack, Telegram, Teams) and filterable table
๐จ Improvements โ
- email: Template redesign โ Shadcn/UI style card layout with zinc palette, color-coded status badges, and dark mode support
- restore: Rich notification context with database type, storage name, backup filename, duration, and failure details
- backup: Selective TAR extraction โ multi-database restores extract only selected databases, reducing I/O
- ui: Skeleton loading placeholders across Storage Explorer, History, and Database Explorer
- storage: Tab-aware refresh โ refresh button reloads the active tab instead of always refreshing the file list
- ui: Database Explorer matches Storage Explorer's visual style with empty state cards
๐ Changed โ
- ui: Replaced Radix ScrollArea with native browser scrollbars across all components
๐ Bug Fixes โ
- setup: Fixed "Please select an adapter type first" error in Quick Setup adapter selection
- setup: Test Connection button now works in all Quick Setup steps
๐ณ Docker โ
- Image:
skyfay/dbackup:v0.9.9-beta - Also tagged as:
beta - Platforms: linux/amd64, linux/arm64
v0.9.8-beta - Notification Adapters Expansion & Quick Setup Wizard โ
Released: February 20, 2026
โจ Features โ
- Slack: Incoming Webhooks with Block Kit formatting, color-coded attachments, channel override, and custom bot identity
- Teams: Power Automate Workflows with Adaptive Cards v1.4 and color mapping
- webhook: Generic webhook adapter โ universal HTTP POST/PUT/PATCH with custom JSON templates, auth headers, and custom headers
- Gotify: Self-hosted push notifications with configurable priority levels and Markdown formatting
- ntfy: Topic-based push notifications (public or self-hosted) with priority escalation and emoji tags
- Telegram: Bot API with HTML formatting, flexible targets (chats, groups, channels), and silent mode
- Twilio: SMS alerts with concise formatting optimized for message length and E.164 phone numbers
- setup: Quick Setup Wizard โ 7-step guided first-run (Source โ Destination โ Vault โ Notification โ Job โ Run)
- navigation: Grouped sidebar organized into General, Backup, Explorer, and Administration groups
๐ Documentation โ
- notifications: Per-channel setup guides for all 9 notification channels
๐ Bug Fixes โ
- scheduler: Enabling/disabling automated config backup now takes effect immediately without restart
- ui: Storage History button and Health History popover now respect user permissions
- API: Health History endpoint accepts either
sources:readordestinations:read
๐ณ Docker โ
- Image:
skyfay/dbackup:v0.9.8-beta - Also tagged as:
beta - Platforms: linux/amd64, linux/arm64
v0.9.7-beta - API Keys, Webhook Triggers, Adapter Picker & Brand Icons โ
Released: February 20, 2026
โจ Features โ
- ui: Visual adapter picker โ two-step create flow with card grid, search bar, and category tabs
- ui: Brand icons โ multi-colored SVG logos via Iconify for all adapters, bundled offline for self-hosted deployments
- MSSQL: SSH/SFTP file transfer for accessing
.bakfiles on remote SQL Server hosts with automatic cleanup - MSSQL: Encryption and self-signed certificate toggles exposed in the UI
- restore: Database stats section showing target server databases with sizes, table counts, and conflict detection
- explorer: Database Explorer โ standalone page to browse databases on any source with server overview and sortable stats
- auth: API key management โ fine-grained permissions, expiration dates, secure storage, full lifecycle
- API: Webhook triggers โ trigger backups via
POST /api/jobs/:id/runwith cURL, Bash, and Ansible examples - auth: Unified auth system โ all API routes support both session cookies and API key Bearer tokens
- Docker: Health check โ polls
/api/healthevery 30s returning app status, DB connectivity, and memory usage - auth: Configurable rate limits โ per-category limits (Auth, API Read, API Write) with auto-save UI
- backup: Graceful shutdown โ waits for running backups, freezes queue, stops scheduler, cleans up pending jobs
- storage: Grouped destination selector โ adapters grouped into Local, Cloud Storage, Cloud Drives, and Network categories
- adapters:
getDatabasesWithStats()โ all adapters expose database size and table/collection count - ui: Default port placeholders for MSSQL (1433), Redis (6379), and MariaDB (3306)
- config: Zod-based startup validation for environment variables with clear error messages
๐ Bug Fixes โ
- ui: Fixed
cmdkintercepting mouse wheel scroll events in dropdowns - ui: Fixed conditional form fields appearing before their controlling dropdown is selected
๐ Documentation โ
- wiki: API Reference, API Keys, Webhook Triggers, and Rate Limits guides
๐ณ Docker โ
- Image:
skyfay/dbackup:v0.9.7-beta - Also tagged as:
beta - Platforms: linux/amd64, linux/arm64
v0.9.6-beta - Cloud Storage, Rsync & Notification System โ
Released: February 15, 2026
โจ Features โ
- notifications: System notification framework for user logins, account creation, restore results, and system errors with per-event toggles
- email: Multi-recipient tag/chip input with paste support for comma/semicolon-separated lists
- Google Drive: OAuth 2.0 with encrypted refresh tokens, visual folder browser, and resumable uploads
- Dropbox: OAuth 2.0 with visual folder browser and chunked uploads for files > 150 MB
- OneDrive: OAuth 2.0 for personal and organizational accounts with smart upload strategy
- rsync: Delta transfer via rsync over SSH with Password, Private Key, or SSH Agent auth
- storage: Usage history โ area charts showing storage size over time (7dโ1y) with automatic hourly snapshots
๐ Security โ
- OAuth: Refresh tokens and client secrets encrypted at rest with AES-256-GCM
- rsync: Passwords passed via
SSHPASSenv var, never as CLI arguments
๐จ Improvements โ
- dashboard: Cached storage statistics served from DB cache instead of live API calls, auto-refreshed hourly
- storage: All storage adapters queried in parallel instead of sequentially
๐ Bug Fixes โ
- dashboard: Fixed Job Status chart stretching when many destinations are configured
- ui: Fixed missing adapter details for OneDrive, MariaDB, and MSSQL in tables
๐ณ Docker โ
- Image:
skyfay/dbackup:v0.9.6-beta - Also tagged as:
beta - Platforms: linux/amd64, linux/arm64
v0.9.5-beta - Dashboard Overhaul, Checksums & Visual Analytics โ
Released: February 13, 2026
โจ Features โ
- backup: SHA-256 checksum verification โ end-to-end integrity with checksums on backup, verification on restore, and optional weekly integrity check
- dashboard: Interactive dashboard with activity chart, job status donut, 7 KPI cards, latest jobs widget, and smart auto-refresh
- ui: Smart type filters โ faceted filters on Sources, Destinations, and Notifications pages
- WebDAV: Nextcloud, ownCloud, Synology, and any WebDAV server support
- SMB: Windows servers and NAS devices with configurable protocol version and domain auth
- FTP: FTP/FTPS servers with optional TLS encryption
- storage: Per-destination overview widget with backup count and total size from live file scanning
๐ Bug Fixes โ
- backup: File size now reflects actual compressed/encrypted size instead of raw dump size
- ui: Fixed crash with relative date formatting in DateDisplay component
๐ณ Docker โ
- Image:
skyfay/dbackup:v0.9.5-beta - Also tagged as:
beta - Platforms: linux/amd64, linux/arm64
v0.9.4-beta - Universal Download Links & Logging System โ
Released: February 6, 2026
โจ Features โ
- backup: wget/curl download links โ temporary links with countdown timer, encrypted/decrypted format selection
- logging: Centralized logger with child loggers,
LOG_LEVELenv control, colored dev output (JSON in production) - errors: Custom error class hierarchy (
DBackupError,AdapterError,ServiceError, etc.) withwrapError()utilities - logging: API request middleware logging with method, path, duration, and anonymized IP
๐จ Improvements โ
- adapters: Type-safe adapter configs โ all adapters use exported TypeScript types instead of
config: any - MongoDB: Connection test uses native
mongodbnpm package instead ofmongosh(Docker compatibility)
๐๏ธ Removed โ
- backup: Legacy multi-DB code โ removed
pg_dumpall, MySQL--all-databases, and MongoDB multi-DB parsing (replaced by TAR in v0.9.1)
๐ Documentation โ
- wiki: Download tokens, Storage Explorer, and Logging System developer documentation
๐ณ Docker โ
- Image:
skyfay/dbackup:v0.9.4-beta - Also tagged as:
beta - Platforms: linux/amd64, linux/arm64
v0.9.3-beta - Redis Support, Restore UX & Smart File Extensions โ
Released: February 2, 2026
โจ Features โ
- Redis: RDB snapshot backups for Redis 6/7/8 with Standalone & Sentinel mode, ACL auth, TLS, and database index selection
- Redis: 6-step restore wizard with secure download links (5-min expiry) and platform-specific instructions
- backup: Smart file extensions โ adapter-specific extensions:
.sql,.bak,.archive,.rdb,.db - backup: Token-based downloads โ secure, single-use download links (5-min expiry) for wget/curl without session cookies
- settings: User preferences โ auto-redirect toggle for disabling automatic History page redirection on job start
- Docker Hub: Published at
skyfay/dbackupwith sensibleDATABASE_URLdefault,TZandTMPDIRsupport - config:
TRUSTED_ORIGINSenv var for multiple access URLs (comma-separated)
๐ Bug Fixes โ
- auth: Auth client correctly uses browser origin instead of hardcoded URL
๐ Documentation โ
- wiki: Consolidated installation guide with Docker Compose/Run tab switcher and environment variables audit
๐ณ Docker โ
- Image:
skyfay/dbackup:v0.9.3-beta - Also tagged as:
beta - Platforms: linux/amd64, linux/arm64
v0.9.2-beta - Branding & Documentation โ
Released: February 1, 2026
โจ Features โ
- branding: Official DBackup logo with multi-resolution favicon support and brand integration (login, sidebar, browser tab)
- docs: Documentation portal launched at dbackup.app with in-app link and Discord community
- SEO: Meta tags, Open Graph, Twitter Cards, and structured data
๐ณ Docker โ
- Image:
skyfay/dbackup:v0.9.2-beta - Also tagged as:
beta - Platforms: linux/amd64, linux/arm64
v0.9.1-beta - Unified Multi-DB TAR Architecture โ
Released: February 1, 2026
โ ๏ธ Breaking: Multi-database backups now use TAR archives instead of inline SQL/dump streams. Old multi-DB backups cannot be restored with v0.9.1+. Single-database backups are not affected.
โจ Features โ
- backup: Unified TAR multi-DB format โ all adapters use the same TAR format with
manifest.json, enabling selective restore and database renaming
๐จ Improvements โ
- PostgreSQL: Uses
pg_dump -Fcper database instead ofpg_dumpallfor smaller, parallel-ready backups - MongoDB: True multi-DB support with
--nsFrom/--nsTorenaming on restore
๐งช Tests โ
- integration: 84 integration tests โ multi-DB tests, MSSQL test setup, Azure SQL Edge ARM64 skip
๐ณ Docker โ
- Image:
skyfay/dbackup:v0.9.1-beta - Also tagged as:
beta - Platforms: linux/amd64, linux/arm64
v0.9.0-beta - Microsoft SQL Server & Self-Service Security โ
Released: January 31, 2026
โจ Features โ
- MSSQL: Full adapter with auto-detection of edition/version, multi-DB TAR backups, server-side compression, and parameterized queries
- auth: Password change from profile settings with audit logging
๐งช Tests โ
- testing: Stress test data generator, dedicated
testdbcontainer, and MSSQL/tmpcleanup
๐ณ Docker โ
- Image:
skyfay/dbackup:v0.9.0-beta - Also tagged as:
beta - Platforms: linux/amd64, linux/arm64
v0.8.3-beta - Meta-Backups & System Task Control โ
Released: January 30, 2026
โจ Features โ
- config backup: Self-backup of app configuration (Users, Jobs, Settings) to storage adapters with full restore flow
- encryption: Profile portability โ export/import secret keys for server migration with Smart Recovery
- settings: System task management โ admins can enable/disable background tasks; config backup moved into standard scheduler
๐ณ Docker โ
- Image:
skyfay/dbackup:v0.8.3-beta - Also tagged as:
beta - Platforms: linux/amd64, linux/arm64
v0.8.2-beta - Keycloak, Encryption Imports & Database Reset โ
Released: January 29, 2026
โ ๏ธ Breaking: Database schema consolidated into a single init migration. Delete existing
dev.dband let the app re-initialize. Data cannot be migrated automatically.
โจ Features โ
- SSO: Keycloak adapter โ dedicated OIDC adapter with HTTPS enforcement
- encryption: Profile import for disaster recovery on fresh instances
๐จ Improvements โ
- auth: 2-step email-first login flow with tabbed SSO configuration UI
๐ณ Docker โ
- Image:
skyfay/dbackup:v0.8.2-beta - Also tagged as:
beta - Platforms: linux/amd64, linux/arm64
v0.8.1-beta - SQLite Support & Remote File Browsing โ
Released: January 26, 2026
โจ Features โ
- SQLite: Backup local and remote (via SSH tunnel) SQLite databases with safe restore cleanup
- ui: Remote file browser for browsing local and SSH filesystems, integrated into adapter forms
- SFTP: Distinct Password and Private Key authentication options
๐ณ Docker โ
- Image:
skyfay/dbackup:v0.8.1-beta - Also tagged as:
beta - Platforms: linux/amd64, linux/arm64
v0.8.0-beta - The First Beta โ
Released: January 25, 2026
๐ First official Beta with enterprise-ready features.
โจ Features โ
- SSO: Full OpenID Connect with Authentik, PocketID, and Generic providers including account linking and auto-provisioning
- S3: AWS S3 and compatible providers (MinIO, R2, etc.) via AWS SDK
- SFTP: Secure backup offloading to remote servers with connection testing
- audit: Comprehensive action tracking with IP, User Agent, change diffs, configurable retention, and faceted filtering
- MariaDB: Dedicated adapter with dialect handling
- adapters: Auto-detection of database version and dialect (MySQL 5.7 vs 8.0, etc.)
- system: Update checker โ notifies admins when new versions are available
- adapters: Visual health history grid and badges for all adapters
๐ Security โ
- MySQL: Password handling switched to
MYSQL_PWDenvironment variable
๐งช Tests โ
- testing: Unit and integration tests for backup/restore pipelines, storage, notifications, and scheduler
๐ณ Docker โ
- Image:
skyfay/dbackup:v0.8.0-beta - Also tagged as:
beta - Platforms: linux/amd64, linux/arm64
v0.5.0-dev - RBAC System, Encryption Vault & Core Overhaul โ
Released: January 24, 2026
โจ Features โ
- auth: RBAC system โ user groups with granular permissions, management UI, and protected SuperAdmin group
- encryption: Recovery kits โ offline recovery kits for emergency decryption with master key reveal dialog
- backup: Native compression support integrated into UI and pipeline
- backup: Live progress tracking with indeterminate progress bars for streaming
- auth: API and authentication endpoint rate limiting
- auth: 2FA administration โ admins can reset 2FA for locked-out users
๐จ Improvements โ
- backup: Pipeline architecture โ job runner refactored into modular steps with dedicated service layer
- queue: Max 10 concurrent jobs with optimized MySQL/PostgreSQL streaming
- ui: DataTables with faceted filtering, Command-based Popovers, and Recovery Kit card UI