Article · Wikipedia archive · Last revised Jul 24, 2026

Foreman (software)

Foreman is an open source complete life cycle systems management tool for provisioning, configuring and monitoring of physical and virtual servers. Foreman has integration with configuration management software, such as Ansible, Puppet, Chef, Salt and other solutions through plugins, which allow users to automate repetitive tasks, deploy applications, and manage changes to already deployed servers.

Last revised
Jul 24, 2026
Read time
≈ 6 min
Length
1,434 w
Citations
69
Source
Wikipedia ↗
Foreman
Original authorsPaul Kelly and Ohad Levy
Release10 September 2009 (2009-09-10)1
Stable release
3.19.12Edit this on Wikidata / 1 July 2026 (1 July 2026)
Written inRuby and JavaScript
PlatformCross-platform: Unix, Linux, Microsoft Windows, OS X
Available inEnglish, French, German, Spanish
TypeSystems management
LicenseGPL-3.0
Websitetheforeman.org
Repository

Foreman (also known as The Foreman) is an open source complete life cycle systems management tool for provisioning, configuring and monitoring of physical and virtual servers. Foreman has integration with configuration management software, such as Ansible, Puppet, Chef, Salt and other solutions through plugins, which allow users to automate repetitive tasks, deploy applications, and manage changes to already deployed servers.

Foreman provides provisioning on bare-metal (through managed DHCP, DNS, TFTP, and PXE-based unattended installations), virtualization and cloud. It also includes a web front-end, a command line interface, and a REST API.

History

Initial development on Foreman started in July 2009 under a different project name. Release 0.1 was committed in September 20091 by Ohad Levy.

Availability

Foreman is targeted on Linux operating systems, but users reported successful installations on Microsoft Windows, BSD, and macOS.

The core Foreman team maintains repositories for various Linux distributions: Fedora, Red Hat Enterprise Linux (and derivatives such as CentOS), Debian, and Ubuntu.

Plugins

Foreman comes with freely available plugins to increase functionality. All plugins are available on GitHub.

Release history

Date Version Changes and additions
14 October 2013 1.3.0 Improvements were made in the installation process, API, scalability, existing hosts mapping to compute resources, and more. A new official CLI.
30 January 2014 1.4.0 New compute profiles feature, improved plugin registration and web UI extensibility, Kerberos authentication support, and new smart proxy features.
9 May 2014 1.5.0 Config groups feature for Puppet management, integration with FreeIPA, improved authorization system and image provisioning on oVirt, libvirt and VMware ESX.
11 September 2014 1.6.0 Plugin support for Foreman's Smart Proxy, new API version, support for LDAP or Kerberos groups.
2 December 2014 1.7.0 New features for Foreman's smart class matchers supplying data to Puppet, more advanced networking support, and a build health checker.
28 April 2015 1.8.0 Networking user interface and improved provisioning support, new installer features, and performance enhancements.
18 August 2015 1.9.0 User interface enhancements, improved logging, image provisioning, and e-mail notifications.
23 December 2015 1.10.0 Various host management user interface enhancements, DNS plugin support in Foreman's Smart Proxy.
1 April 2016 1.11.0 Parameter management improvements, new Smart Proxy user interfaces, DHCP plugin support in the Smart Proxy.
8 July 2016 1.12.0 Puppet 4 support, New OS support (Ubuntu Xenial, Fedora 24)
5 October 2016 1.13.0 IPv6 addressing and partial orchestration support, Support for different PXE boot loaders for UEFI booting, ISC DHCP performance improvement, Compute resource enhancements, Facter structured facts support
16 January 2017 1.14.0 Automatic IPv6 addressing for hosts in compute resources, support for exporting templates and see help on how to create them, LDAP enhancements to support putting users in organizations/locations
12 May 2017 1.15.0 Default owner for new hosts, notifications drawer, templates and roles locking, import hosts that are in compute resources, SSH keys deployed differently depending on who creates the host. Many VMWare-related fixes, including performance and host editing.
30 November 2017 1.16.0 Netgroup LDAP authentication, Puppet 5 support, VMWare SCSI controllers with per-disk configuration, Plugin Role Locking
17 April 2018 1.17.0 HTTP proxy for outgoing requests, Vertical navigation, Host interfaces auditing, Warning for unsupported PXE loader combinations
19 July 2018 1.18.0 Template importing, RancherOS provisioning support, MTU support for subnets, breadcrumb navigation
31 August 2018 1.19.0 Ubuntu Bionic support, Support for logging to journald or syslog, Full cloud-init support for oVirt
18 November 2018 1.20.0 Report templates, Template rendering engine rewrite, FIPS compliance, UI improvements
1 March 2019 1.21.0 New Diff viewer, Huawei VRP support, Performance, and stabilization
4 June 2019 1.22.03 Array, Boolean, and other types support in Parameters, Compute resource libraries update, Graphql API, Smart Proxy Exposed Capabilities and Settings, Puppet 6 support4
29 August 2019 1.22.13 Maintenance release4
4 November 2020 1.22.23 Maintenance release4
10 September 2019 1.23.03 New Login Page, Foreman Userdata plugin has been merged into Foreman Core, Impersonation capability added, Multiple improvements to GCE compute resource, Javascript stack improvements, Experimental Redis cache support5
4 November 2020 1.23.13 Maintenance release5
12 March 2020 1.23.23 Maintenance release5
9 December 2019 1.24.03 Support for Azure Resource Manager Compute Resource, Single Sign-On (SSO) support using OpenID-Connect, Debian 10 (Buster) support, Dynflow deployment with Sidekiq, Cockpit single sign-on, New status API endpoints6
8 January 2020 1.24.13 Maintenance release6
21 January 2020 1.24.23 Maintenance release6
20 May 2020 1.24.33 Maintenance release6
2 April 2020 2.0.03 New sidekiq-based implementation for Dynflow, Consolidating on PostgreSQL as only supported database, Database migrations and seeding no longer run as part of package installation, Improved UI for managing authentication sources7
9 June 2020 2.0.13 Maintenance release7
19 August 2020 2.0.23 Maintenance release7
1 July 2020 2.1.03 External IPAM, Rails 6 upgrade, Support installation on EL8 distributions, Switch default web server from Passenger to Puma8
3 August 2020 2.1.13 Maintenance release8
20 August 2020 2.1.23 Maintenance release8
28 October 20209 2.2.010 • Templates DSL documentation
• Disabling users
• API pagination supports ‘all’
• Experimental host details page
1 December 20209 2.3.011 • Host registration
• Safe mode template preview when safe mode rendering is disabled
• Show instance name in top menu
19 March 20219 2.4.012 • Ansible inventory template
• Services only allow TLS 1.2+ connections by default
• Managing personal access tokens through the Foreman web UI
• Support for Redfish to BMC Smart Proxy
2 June 20219 2.5.013 • Ubuntu 20.04 (Focal) support
• CentOS Stream 8 support
• Host registration improvements
• Audits performance improvements
• Removal of mod_passenger support
• New kind of facts in Discovery plugin
7 September 20219 3.0.014 • Puppet ENC functionality extracted to foreman_puppet plugin
• Kerberos authentication using mod_auth_gssapi
• Fact parsers are included in core
• Deprecated support for running Foreman on Ubuntu 18.04 or EL 7
9 December 20219 3.1.015 • Improvements and additions to the new Host Details page: Insights tab, Ansible tab, PatternFly 4 Search tab, New Build button and card for BMC Power Management
• Descriptions for all of the provisioning templates
• New purge:puppet rake task
• Cron job to clean old Audits
• Provisioning snippets support Puppet 7
• Performance improvements for index pages and Host Config Status
• Dropped support for running Foreman on Ubuntu 18.04
• Deprecated the :unattended setting
15 March 20229 3.2.016 • Debian 11 (Bullseye) support
• require_ssl_smart_proxies setting dropped
• Deprecated support for running Foreman on EL7 and Debian 10 (Buster)
9 June 20229 3.3.017 • DSL Autocompletion in templates
• EL9 Client repository
• Disabling unattended mode dropped
• BMC credentials access turned off by default
• Updated browser compatibility
• Deprecated support for running Foreman on Ruby 2.5
8 September 20229 3.4.018
14 December 20229 3.5.019 • Improved inventory pages
• Enabled HTTP/2 on Apache
• Use of system crypto policy with Apache on Enterprise Linux 8
• Redis 6 on Enterprise Linux 8
• Allow manual modifications of ansible.cfg
21 March 20239 3.6.020 • Redis cache can now be managed by the installer
• New installations will disable Puppetserver's telemetry by default
• foreman_memcache plugin was removed
• Puppet 6 is EOL
20 June 20239 3.7.021 • Plugin translation infrastructure in frontend
• Puma updated to version 6
• Puppet 6 support dropped
12 October 2023 3.8.022
3 January 2024 3.9.023
25 March 2024 3.10.024
  • EL 9 support added
25 June 2024 3.11.025
19 September 2024 3.12.026
3 December 2024 3.13.027
  • EL 8 support removed
19 March 2025 3.14.028
10 June 2025 3.15.029
10 September 2025 3.16.030
9 December 2025 3.17.031
11 March 2026 3.18.0
  • SSH certificate support for remote execution
See also

See also

References

References

  1. "Initial tag in git". GitHub.
  2. "Release 3.19.1". 1 July 2026. Retrieved 2 July 2026.
  3. "theforeman/foreman". GitHub. Retrieved 3 September 2020.
  4. "Foreman :: Manual". theforeman.org. Retrieved 3 September 2020.
  5. "Foreman :: Manual". theforeman.org. Retrieved 3 September 2020.
  6. "Foreman :: Manual". theforeman.org. Retrieved 3 September 2020.
  7. "Foreman :: Manual". theforeman.org. Retrieved 3 September 2020.
  8. "Foreman :: Manual". theforeman.org. Retrieved 3 September 2020.
  9. "Tags · theforeman/Foreman". GitHub.
  10. "Foreman :: Manual".
  11. "Foreman :: Manual".
  12. "Foreman :: Manual".
  13. "Foreman :: Manual".
  14. "Foreman :: Manual".
  15. "Foreman :: Manual".
  16. "Foreman :: Manual".
  17. "Foreman :: Manual".
  18. "Foreman :: Manual".
  19. "Foreman :: Manual".
  20. "Foreman :: Manual".
  21. "Foreman :: Manual".
  22. "Foreman 3.8 Manual".
  23. "Foreman 3.9 Manual".
  24. "Foreman 3.10 Manual".
  25. "Foreman 3.11 Manual".
  26. "Foreman 3.12 Manual".
  27. "Foreman 3.13 Manual".
  28. "Foreman 3.14 Manual".
  29. "Foreman 3.15 Manual".
  30. "Foreman 3.16 Manual".
  31. "Foreman 3.17 Manual".
External links