flippercloud/flipper · error · RuntimeError

Your database needs to be migrated to use the latest Flipper

Error message

Your database needs to be migrated to use the latest Flipper features.
See https://github.com/flippercloud/flipper/issues/557

What it means

Error "Your database needs to be migrated to use the latest Flipper features. See https://github.com/flippercloud/flipper/issues/557" thrown in flippercloud/flipper.

Source

Thrown at lib/flipper/adapters/sequel.rb:182

          @gate_class.where(gate_attrs(feature, gate, thing, json: gate.data_type == :json)).delete
        else
          unsupported_data_type gate.data_type
        end

        true
      end

      private

      def unsupported_data_type(data_type)
        raise "#{data_type} is not supported by this adapter"
      end

      def set(feature, gate, thing, options = {})
        clear_feature = options.fetch(:clear, false)
        json_feature = options.fetch(:json, false)

        raise VALUE_TO_TEXT_WARNING if json_feature && value_not_text?

        @gate_class.db.transaction do
          clear(feature) if clear_feature
          delete(feature, gate)

          begin
            @gate_class.create(gate_attrs(feature, gate, thing, json: json_feature))
          rescue ::Sequel::UniqueConstraintViolation
          end
        end
      end

      def delete(feature, gate)
        @gate_class.where(feature_key: feature.key, key: gate.key.to_s).delete
      end

      def enable_multi(feature, gate, thing)
        begin

View on GitHub (pinned to 1f86de3ec9)

Solutions

1. Run the Sequel migrations shipped with flipper, e.g. Sequel::Migrator.run(DB, 'lib/flipper/adapters/sequel/migrations') or the rake task your app provides
2. See https://github.com/flippercloud/flipper/issues/557 for the exact migration SQL for your flipper version
3. After migrating, restart the application so the adapter picks up the new schema

When it happens

Trigger: Thrown at lib/flipper/adapters/sequel.rb:182 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of flippercloud/flipper@1f86de3ec9 (2026-08-23). Data as JSON: /api/errors/7b934dce7ddb0710. Report an issue: GitHub.