theforeman/foreman · error · Foreman::MaintenanceException

There are migrations pending in the system.

Error message

There are migrations pending in the system.

What it means

Error "There are migrations pending in the system." thrown in theforeman/foreman.

Source

Thrown at app/controllers/concerns/foreman/controller/migration_checker.rb:17

module Foreman::Controller::MigrationChecker
  extend ActiveSupport::Concern

  included do
    before_action :check_pending_migrations
  end

  def self.needs_migration?
    return @needs_migration unless @needs_migration.nil?
    @needs_migration = ::Foreman.pending_migrations?
  end

  private

  def check_pending_migrations
    if Foreman::Controller::MigrationChecker.needs_migration?
      raise Foreman::MaintenanceException, _("There are migrations pending in the system.")
    end
  end
end

View on GitHub (pinned to 6b05625475)

When it happens

Trigger: Thrown at app/controllers/concerns/foreman/controller/migration_checker.rb:17 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of theforeman/foreman@6b05625475 (2026-08-23). Data as JSON: /api/errors/25629cbff19cc28a. Report an issue: GitHub.