flippercloud/flipper · error · ArgumentError

Flipper::Cloud #{name} is missing. Please set #{env_var} or

Error message

Flipper::Cloud #{name} is missing. Please set #{env_var} or provide #{name} (e.g. Flipper::Cloud.new(#{name}: value)).

What it means

Error "Flipper::Cloud #{name} is missing. Please set #{env_var} or provide #{name} (e.g. Flipper::Cloud.new(#{name}: value))." thrown in flippercloud/flipper.

Source

Thrown at lib/flipper/cloud/configuration.rb:262

        value = options.fetch(name) {
          default_value = default.respond_to?(:call) ? default.call : default
          if from_env
            ENV.fetch(env_var, default_value)
          else
            default_value
          end
        }
        value = Flipper::Typecast.send("to_#{typecast}", value) if typecast
        send("#{name}=", value)
        enforce_minimum(name, minimum) if minimum

        if required
          option_value = send(name)
          if option_value.nil? || option_value.empty?
            message = String.new("Flipper::Cloud #{name} is missing. Please ")
            message << "set #{env_var} or " if from_env
            message << "provide #{name} (e.g. Flipper::Cloud.new(#{name}: value))."
            raise ArgumentError, message
          end
        end
      end

      # Enforce minimum interval for tasks that run on a timer.
      def enforce_minimum(name, minimum)
        provided = send(name)
        if provided && provided < minimum
          warn "Flipper::Cloud##{name} must be at least #{minimum} seconds but was #{provided}. Using #{minimum} seconds."
          send(:instance_variable_set, "@#{name}", minimum)
        end
      end
    end
  end
end

View on GitHub (pinned to 1f86de3ec9)

Solutions

1. Set the required environment variable named in the message (e.g. FLIPPER_CLOUD_TOKEN) before initializing Flipper::Cloud
2. Pass the option explicitly: Flipper::Cloud.new(token: '...', ...) for whichever value is missing
3. Verify your initializer loads credentials before Flipper::Cloud is configured (ordering bug in initializers)

When it happens

Trigger: Thrown at lib/flipper/cloud/configuration.rb:262 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/7e64a00d829dad89. Report an issue: GitHub.