ddollar/foreman · error · TypeError

must use a subclass of Foreman::Engine

Error message

must use a subclass of Foreman::Engine

What it means

Error "must use a subclass of Foreman::Engine" thrown in ddollar/foreman.

Source

Thrown at lib/foreman/engine.rb:297

  # Get the base port for this foreman instance
  #
  # @returns [Fixnum] port  The base port
  #
  def base_port
    (options[:port] || env["PORT"] || ENV["PORT"] || 5000).to_i
  end

  # deprecated
  def environment
    env
  end

private

### Engine API ######################################################

  def startup
    raise TypeError, "must use a subclass of Foreman::Engine"
  end

  def output(name, data)
    raise TypeError, "must use a subclass of Foreman::Engine"
  end

  def shutdown
    raise TypeError, "must use a subclass of Foreman::Engine"
  end

## Helpers ##########################################################

  def create_pipe
    IO.method(:pipe).arity.zero? ? IO.pipe : IO.pipe("BINARY")
  end

  def name_for(pid)
    process, index = @running[pid]

View on GitHub (pinned to f65ddba839)

When it happens

Trigger: Thrown at lib/foreman/engine.rb:297 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of ddollar/foreman@f65ddba839 (2026-08-21). Data as JSON: /api/errors/09b212473987aab0. Report an issue: GitHub.