onetimesecret/onetimesecret · error · ArgumentError

Unknown mail provider: '#{name}'. Supported: #{providers.joi

Error message

Unknown mail provider: '#{name}'. Supported: #{providers.join(', ')}

What it means

Error "Unknown mail provider: '#{name}'. Supported: #{providers.join(', ')}" thrown in onetimesecret/onetimesecret.

Source

Thrown at lib/onetime/mail/provider_registry.rb:302

          DESCRIPTORS.keys
        end

        # @return [Array<Descriptor>] descriptors in registry order
        def descriptors
          DESCRIPTORS.values
        end

        # @param name [String, Symbol, nil] provider name (case-insensitive)
        # @return [Descriptor, nil] nil when unknown
        def descriptor(name)
          DESCRIPTORS[normalize(name)]
        end

        # @param name [String, Symbol] provider name
        # @return [Descriptor]
        # @raise [ArgumentError] naming the supported providers when unknown
        def descriptor!(name)
          descriptor(name) or raise ArgumentError,
            "Unknown mail provider: '#{name}'. Supported: #{providers.join(', ')}"
        end

        # @return [Array<String>] providers supporting automated provisioning
        def provisioning_providers
          descriptors.select(&:provisioning?).map(&:name)
        end

        # @param name [String, Symbol, nil] provider name
        # @return [Boolean] true when the provider supports provisioning
        def provisioning_provider?(name)
          descriptor(name)&.provisioning? || false
        end

        # @return [Array<String>] providers with a pollable feedback API
        def feedback_providers
          descriptors.select(&:feedback?).map(&:name)
        end

View on GitHub (pinned to f81295e41b)

Solutions

  1. Change the configured mail provider name to one of the supported providers listed in the message.

When it happens

Trigger: Thrown at lib/onetime/mail/provider_registry.rb:302 when the library encounters an invalid state.

Common situations: See trigger scenarios.


AI-assisted analysis of onetimesecret/onetimesecret@f81295e41b (2026-08-23). Data as JSON: /api/errors/a01958fa9e09df5f. Report an issue: GitHub.