Skip to content

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 validate stage running lint, type-check, and tests in parallel before Docker builds
  • pipeline: Split single docker buildx into parallel amd64/arm64 jobs, combined via imagetools 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/api and 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_init migration. Existing beta databases are not compatible. Export your config via Settings โ†’ Config Backup before upgrading, then re-import after npx 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/Pending and marks them as Failed
  • 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 Partial status
  • 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: clientId and clientSecret encrypted 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 Pending executions
  • API: Bash trigger script checks success: true before parsing; documented history:read requirement
  • auth: Split rate limit module into Edge-safe and server-only to avoid node:crypto import 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:read or destinations: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 .bak files 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/run with 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/health every 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 cmdk intercepting 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 SSHPASS env 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

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_LEVEL env control, colored dev output (JSON in production)
  • errors: Custom error class hierarchy (DBackupError, AdapterError, ServiceError, etc.) with wrapError() 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 mongodb npm package instead of mongosh (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/dbackup with sensible DATABASE_URL default, TZ and TMPDIR support
  • config: TRUSTED_ORIGINS env 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 -Fc per database instead of pg_dumpall for smaller, parallel-ready backups
  • MongoDB: True multi-DB support with --nsFrom/--nsTo renaming 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 testdb container, and MSSQL /tmp cleanup

๐Ÿณ 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.db and 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_PWD environment 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

Released under the GNU General Public License. | Privacy ยท Legal Notice