kamal-backup 0.1.0.pre.9 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dffee9d885ca23342a84ac3fc494d09f9f44b323a10ae981df4665f31206b20a
-  data.tar.gz: 0c6352b4f00008b54b22442f0b192eb54adf7f52c0350ab8cb5c69dd1cff9c4f
+  metadata.gz: 7135af9b16454829f69ed19ca84d58045232e5db583cc54cbc1fe623bf80c4f6
+  data.tar.gz: 8f70a9143faec5b730e3e9d70a33b4bed4f1f650815f81c97c303766151fd2af
 SHA512:
-  metadata.gz: 77f916eec58efe57ad7c1b65b8f93cab39d647b9051dc6d77cbebfa66f830cbc65bfdf9bdfc8aa0016109969a88b68bef8f2ea79a71a97ce4670b6c1028fa8ba
-  data.tar.gz: 631793de8449a07bf774f91a5bf7aea669b4773da960a27319cf8ecca00c6194a37214f36cc70c49857247406e665292318ad145f9c9e87d15f53751b92bf00a
+  metadata.gz: a919c1e57b6061ce588bd73d00b87eeff13e7b312b3da1bf05d8263116eadc119facc2fedadcba62d21a4d0983835bb52b89486eb13beeeffb3673588ec39845
+  data.tar.gz: 64739bbaac082b4266d37b2dfbd70d4ad53c7010a825a037126ff4b9cfb828c0968d2dd1045c25cd82fab5371864a2405c10c0edee99152948131f8d8112bf38

data/README.md

@@ -59,6 +59,8 @@ For most Rails apps, that is enough. `restore local` and `drill local` can infer
 
 Only create `config/kamal-backup.local.yml` if you need to override those local defaults.
 
+Local restore and drill also require the `restic` binary on your machine. The backup accessory image already includes `restic` for production-side commands.
+
 Then add the backup accessory to `config/deploy.yml`:
 
 ```yaml
@@ -193,6 +195,8 @@ You still provide the local secrets yourself in env:
 - `POSTGRES_PASSWORD` or `MYSQL_PWD` when needed
 - `RESTIC_REPOSITORY` when it is not visible through `kamal config`
 
+And you need `restic` installed locally and available on `PATH`.
+
 Example:
 
 ```sh
@@ -217,6 +221,8 @@ It prompts locally, then shells out through Kamal to the backup accessory.
 bundle exec kamal-backup -d production drill local latest --check "bin/rails runner 'puts User.count'"
 ```
 
+Like `restore local`, this runs on your machine and requires a local `restic` install.
+
 `drill production` restores into scratch targets on production infrastructure. It does not touch the live production database:
 
 ```sh

data/exe/kamal-backup

@@ -1,10 +1,15 @@
 #!/usr/bin/env ruby
 
-ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../Gemfile", __dir__)
+root = File.expand_path("..", __dir__)
+gemfile = File.join(root, "Gemfile")
+libdir = File.join(root, "lib")
 
-require "bundler/setup"
+$LOAD_PATH.unshift(libdir) if File.directory?(libdir) && !$LOAD_PATH.include?(libdir)
 
-$LOAD_PATH.unshift(File.expand_path("../lib", __dir__))
+if File.exist?(gemfile)
+  ENV["BUNDLE_GEMFILE"] ||= gemfile
+  require "bundler/setup"
+end
 
 require "kamal_backup"
 

data/lib/kamal_backup/app.rb

@@ -29,6 +29,7 @@ module KamalBackup
 
     def backup
       config.validate_backup
+      require_restic!
 
       timestamp = current_timestamp
       restic.ensure_repository
@@ -48,6 +49,7 @@ module KamalBackup
 
     def restore_to_local_machine(snapshot = "latest")
       validate_local_machine_restore
+      require_restic!
 
       build_restore_result("local", snapshot) do |result|
         adapter = database
@@ -63,6 +65,7 @@ module KamalBackup
 
     def restore_to_production(snapshot = "latest")
       validate_production_restore
+      require_restic!
 
       build_restore_result("production", snapshot) do |result|
         adapter = database
@@ -77,6 +80,7 @@ module KamalBackup
 
     def drill_on_local_machine(snapshot = "latest", check_command: nil)
       validate_local_machine_restore
+      require_restic!
 
       run_drill("local", snapshot, check_command: check_command) do |result|
         adapter = database
@@ -92,6 +96,7 @@ module KamalBackup
 
     def drill_on_production(snapshot = "latest", database_name: nil, sqlite_path: nil, file_target: "/restore/files", check_command: nil)
       validate_production_drill(file_target, database_name, sqlite_path)
+      require_restic!
 
       run_drill("production", snapshot, check_command: check_command) do |result|
         adapter = database
@@ -113,16 +118,19 @@ module KamalBackup
 
     def snapshots
       config.validate_restic
+      require_restic!
       restic.snapshots.stdout
     end
 
     def check
       config.validate_restic
+      require_restic!
       restic.check.stdout
     end
 
     def evidence
       config.validate_restic
+      require_restic!
       @evidence_class.new(config, restic: restic, redactor: redactor).to_json
     end
 
@@ -312,6 +320,14 @@ module KamalBackup
         config.validate_local_database_restore_target(adapter.current_target_identifier)
       end
 
+      def require_restic!
+        return unless using_builtin_restic?
+        return if Command.available?("restic")
+
+        raise ConfigurationError,
+          "restic is required on PATH for commands that run on this machine. Install restic locally and try again."
+      end
+
       def run_drill_check(command)
         result = Command.capture(
           CommandSpec.new(argv: ["sh", "-lc", command]),
@@ -347,6 +363,10 @@ module KamalBackup
         @restic ||= Restic.new(config, redactor: redactor)
       end
 
+      def using_builtin_restic?
+        @restic.nil? || @restic.is_a?(Restic)
+      end
+
       def database
         @database ||= Databases::Base.build(config, redactor: redactor)
       end

data/lib/kamal_backup/cli.rb

@@ -329,6 +329,7 @@ module KamalBackup
       puts deploy_snippet
       puts
       puts "For most Rails apps, restore local and drill local can infer the development database, storage path, and tmp state directory."
+      puts "Local restore and drill also require the restic binary on your machine."
       puts "Create config/kamal-backup.local.yml only if you need to override those local defaults."
     end
 

data/lib/kamal_backup/command.rb

@@ -26,6 +26,13 @@ module KamalBackup
 
   class Command
     class << self
+      def available?(name)
+        ENV.fetch("PATH", "").split(File::PATH_SEPARATOR).any? do |dir|
+          path = File.join(dir, name)
+          File.executable?(path) && !File.directory?(path)
+        end
+      end
+
       def capture(spec, input: nil, redactor:)
         stdout, stderr, status = Open3.capture3(spec.env, *spec.argv, stdin_data: input)
         result = CommandResult.new(stdout: stdout, stderr: stderr, status: status.exitstatus)

data/lib/kamal_backup/databases/base.rb

@@ -88,10 +88,7 @@ module KamalBackup
         end
 
         def executable_available?(name)
-          ENV.fetch("PATH", "").split(File::PATH_SEPARATOR).any? do |dir|
-            path = File.join(dir, name)
-            File.executable?(path) && !File.directory?(path)
-          end
+          Command.available?(name)
         end
     end
   end

data/lib/kamal_backup/version.rb

@@ -1,3 +1,3 @@
 module KamalBackup
-  VERSION = "0.1.0.pre.9"
+  VERSION = "0.1.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: kamal-backup
 version: !ruby/object:Gem::Version
-  version: 0.1.0.pre.9
+  version: 0.1.0
 platform: ruby
 authors:
 - crmne
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-04-23 00:00:00.000000000 Z
+date: 2026-04-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor