Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Smart Proxy is a free open source project that provides restful API to subsystems such as DNS, DHCP, etc, for higher level orchestration tools such as Foreman.

  • Issues: Redmine
  • Wiki: Foreman wiki
  • Community and support: We have a forum and use Libera IRC channels
    • #theforeman for general support
    • #theforeman-dev for development chat

Supported Modules

Currently Supported modules:

  • BMC - BMC management of devices supported by freeipmi and ipmitool
  • DHCP - ISC DHCP and MS DHCP Servers
  • DNS - Bind and MS DNS Servers
  • Puppet - Puppetserver 6 or 7
  • Puppet CA - Manage certificate signing, cleaning and autosign on a Puppet CA server
  • Realm - Manage host registration to a realm (e.g. FreeIPA)
  • TFTP - any UNIX based tftp server
  • Facts - module to gather facts from facter (used only on discovered nodes)
  • HTTPBoot - endpoint exposing a (TFTP) directory via HTTP(s) for UEFI HTTP booting
  • Logs - log buffer of proxy logs for easier troubleshooting
  • Templates - unattended Foreman endpoint proxy


Read the Smart Proxy Installation section of the manual.


Read the Smart Proxy Settings section of the manual.

For Developers

Special thanks

The original author of this project is Ohad Levy. You can find a more thorough list of people who have contributed to this project at some point in Contributors.


See LICENSE file.