kamal-backup 0.2.6 → 0.2.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 446615d131dce8d1bbece3ca08f663472dd3cf76bd66d576e9e9e9f256560f7a
-  data.tar.gz: 073254be6dba231b897c613a991df30f558e0812cdb1a03640a47a6fb7721cef
+  metadata.gz: 8322ff9eeead7c145127274766d96c54677333fafd7a94b57c6eb7b395cfeae6
+  data.tar.gz: b9b1d442c93b808b4d0e04c9fdd3eb757ff97df2470610769bd7e430836107e9
 SHA512:
-  metadata.gz: 556c8066fd8fd4ac18d89bd75280e88ae1fe65e8cb2c882219575553e5f0d584bed21bf9fb8c686212630fd475d37e649016399951b1f125ee84d8ee503d3322
-  data.tar.gz: a7e278ee0679a6511919681a8106977c79ffc63a719ba4889048921c605fb7d888ad786e9329b76ca94019a650a66831f89e347ff94e7e5d1964fe0f2e0e75d4
+  metadata.gz: 4d4031c8ffaa652db3f151c3b21cbf2e170571278a57d815880fa4bbe5a06d6dfce9690d9f59fbe5e68de77c97c6e1ac6a1da90c4c400ccb8af2acaf7d18cec7
+  data.tar.gz: f037233779d710baadf2c6c5e4100b8caccda9069d95b781411fbe35f5c8e4b93899c41d0652f6baa69f38f7e8107c83b65ef19d3ee988397067e5c40e0ae0b7

data/README.md

@@ -30,7 +30,7 @@ Most self-hosted Rails apps need the same things:
 - file-backed Active Storage backups from mounted volumes
 - a fast way to restore production data locally
 - restore drills that do not touch the live production database
-- evidence that says more than "the backup job is green"
+- evidence that says more than "the backup ran"
 
 `kamal-backup` packages that workflow into a small Ruby gem, a production accessory image, and a restic repository.
 

data/lib/kamal_backup/databases/sqlite.rb

@@ -1,5 +1,6 @@
 require "fileutils"
 require "tempfile"
+require "uri"
 require_relative "base"
 
 module KamalBackup
@@ -17,10 +18,7 @@ module KamalBackup
         source = sqlite_source
         Tempfile.create(["kamal-backup-", ".sqlite3"]) do |tempfile|
           tempfile.close
-          Command.capture(
-            CommandSpec.new(argv: ["sqlite3", source, ".backup #{sqlite_literal(tempfile.path)}"]),
-            redactor: redactor
-          )
+          backup_to_file(source, tempfile.path)
           restic.backup_file(
             tempfile.path,
             filename: database_filename(timestamp),
@@ -55,6 +53,40 @@ module KamalBackup
           config.required_value("SQLITE_DATABASE_PATH")
         end
 
+        def backup_to_file(source, target)
+          run_backup(source, target)
+        rescue CommandError => e
+          raise unless immutable_retry_safe?(source, e)
+
+          # Immutable mode skips WAL change detection, so only use it when no WAL sidecar exists.
+          run_backup(sqlite_immutable_uri(source), target)
+        end
+
+        def run_backup(source, target)
+          Command.capture(
+            CommandSpec.new(argv: ["sqlite3", source, ".backup #{sqlite_literal(target)}"]),
+            redactor: redactor
+          )
+        end
+
+        def immutable_retry_safe?(source, error)
+          readonly_database_error?(error) &&
+            !File.exist?("#{source}-wal") &&
+            !File.exist?("#{source}-shm")
+        end
+
+        def readonly_database_error?(error)
+          error.stderr.include?("readonly database") || error.message.include?("readonly database")
+        end
+
+        def sqlite_immutable_uri(source)
+          path = File.expand_path(source).split("/").map do |part|
+            URI.encode_www_form_component(part).gsub("+", "%20")
+          end.join("/")
+
+          "file:#{path}?immutable=1"
+        end
+
         def validate_scratch_restore_target(target)
           if File.expand_path(sqlite_source) == File.expand_path(target)
             raise ConfigurationError, "scratch SQLite path must differ from SQLITE_DATABASE_PATH"

data/lib/kamal_backup/version.rb

@@ -1,3 +1,3 @@
 module KamalBackup
-  VERSION = "0.2.6"
+  VERSION = "0.2.7"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: kamal-backup
 version: !ruby/object:Gem::Version
-  version: 0.2.6
+  version: 0.2.7
 platform: ruby
 authors:
 - crmne
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-04-28 00:00:00.000000000 Z
+date: 2026-05-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor