DatabaseCleaner/database_cleaner · error · DatabaseCleaner::Safeguard::Error::RemoteDatabaseUrl

ENV['DATABASE_URL'] is set to a remote URL. Please refer to

Error message

ENV['DATABASE_URL'] is set to a remote URL. Please refer to https://github.com/DatabaseCleaner/database_cleaner#safeguards

What it means

Error "ENV['DATABASE_URL'] is set to a remote URL. Please refer to https://github.com/DatabaseCleaner/database_cleaner#safeguards" thrown in DatabaseCleaner/database_cleaner.

Source

Thrown at lib/database_cleaner/safeguard.rb:48

      private

        def database_url_not_allowed?
          !DatabaseCleaner.url_allowlist.any? {|allowed| allowed === ENV['DATABASE_URL'] }
        end

        def skip?
          !DatabaseCleaner.url_allowlist
        end
    end


    class RemoteDatabaseUrl
      LOCAL = %w(localhost 127.0.0.1)

      def run
        return if skip?
        raise Error::RemoteDatabaseUrl if remote?(ENV['DATABASE_URL'])
      end

      private

        def remote?(url)
          return false unless url
          parsed = URI.parse(url)
          return false if parsed.scheme == 'sqlite' || parsed.scheme == 'sqlite3'

          host = parsed.host
          return false if host.nil? || host.empty?
          return false if LOCAL.include?(host)
          return false if host.end_with? '.local'
          true
        end

        def skip?
          ENV['DATABASE_CLEANER_ALLOW_REMOTE_DATABASE_URL'] ||

View on GitHub (pinned to 09b47d03cc)

When it happens

Trigger: Thrown at lib/database_cleaner/safeguard.rb:48 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of DatabaseCleaner/database_cleaner@09b47d03cc (2026-08-23). Data as JSON: /api/errors/12c9b5e27588bf5d. Report an issue: GitHub.