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 Freenode 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 - Any Puppet server from 0.24.x
• 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

Installation

Read the Smart Proxy Installation section of the manual.

Configuration

Read the Smart Proxy Settings section of the manual.

For Developers

• API Reference
• Smart Proxy Plugin development [how-to] (https://projects.theforeman.org/projects/foreman/wiki/How_to_Create_a_Smart-Proxy_Plugin)

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.

License

See LICENSE file.