theforeman/foreman · error · ProxyException

Unable to fetch TFTP boot file

Error message

Unable to fetch TFTP boot file

What it means

Error "Unable to fetch TFTP boot file" thrown in theforeman/foreman.

Source

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

    # Deletes a TFTP boot entry
    # [+kind+] : PXE template kind
    # [+mac+] : String in coloned sextuplet format
    # Returns : Boolean status
    def delete(kind, mac)
      parse(super("#{kind}/#{mac}"))
    rescue => e
      raise ProxyException.new(url, e, N_("Unable to delete TFTP boot entry for %s"), mac)
    end

    # Requests that the proxy download the bootfile from the media's source
    # [+args+] : Hash containing
    #   :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

View on GitHub (pinned to 6b05625475)

When it happens

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