theforeman/foreman · error · ProxyException

Unable to detect TFTP boot server

Error message

Unable to detect TFTP boot server

What it means

Error "Unable to detect TFTP boot server" thrown in theforeman/foreman.

Source

Thrown at app/services/proxy_api/tftp.rb:54

    #   :prefix => String containing the location within the TFTP tree to store the file
    #   :path   => String containing the URL of the file to download
    # Returns    : Boolean status
    def fetch_boot_file(args)
      parse(post(args, "fetch_boot_file"))
    rescue => e
      raise ProxyException.new(url, e, N_("Unable to fetch TFTP boot file"))
    end

    # returns the TFTP boot server for this proxy
    def bootServer
      if (response = parse(get("serverName"))) && response["serverName"].present?
        return response["serverName"]
      end
      false
    rescue RestClient::ResourceNotFound
      nil
    rescue => e
      raise ProxyException.new(url, e, N_("Unable to detect TFTP boot server"))
    end

    # Create a default pxe menu
    # [+args+] : Hash containing
    #   :menu => String containing the menu text
    # Returns    : Boolean status
    def create_default(kind, args)
      parse(post(args, "#{kind}/create_default"))
    rescue => e
      raise ProxyException.new(url, e, N_("Unable to create default TFTP boot menu"))
    end
  end
end

View on GitHub (pinned to 6b05625475)

When it happens

Trigger: Thrown at app/services/proxy_api/tftp.rb:54 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/d546b1e176cd89fe. Report an issue: GitHub.