Skip to content
A plugin for querying and orchestrating WDS servers with Foreman
Ruby HTML JavaScript
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
config Fix provisioning issue with discovered hosts Apr 4, 2019
.gitignore Initial commit Apr 26, 2018
foreman_wds.gemspec Initial commit Apr 26, 2018

Foreman Windows Deployment Service

This plugin adds extended support to Foreman for querying and orchestrating WDS servers.

Nota Bene; to support locally booting your installation, you need to have a regular DHCP/TFTP setup in place, that can serve PXE files for the PXE loader chosen for the WDS host.
If you don't want the lifecycle management features of Foreman, you can ignore this requirement and only PXE boot the WDS host when it is to be built.

Not yet implemented:

  • Install image orchestration
  • Unattend file deployment
    • Recommended to build a http client (curl/wget/etc) into your boot image and download to drive the setup.


Foreman Version Plugin Version
>= 1.16 any


See the Plugins install instructions, advanced installation from gems for information on how to install this plugins.

This plugin has JavaScript assets that require precompilation if installed into a packaged Foreman install. You will need to install the foreman-assets package and run foreman-rake plugin:assets:precompile[foreman_wds] after installing it from gem.


Bug reports and pull requests are welcome on GitHub at


The gem is available as open source under the terms of the MIT License.

You can’t perform that action at this time.