Skip to content

RESTful proxies for DNS, DHCP, TFTP, BMC and Puppet

License

Notifications You must be signed in to change notification settings

theforeman/smart-proxy

Repository files navigation

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

Installation

Read the Smart Proxy Installation section of the manual.

Configuration

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.

License

See LICENSE file.