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

Foreman XEN Plugin

Build Status Code Climate

This plugin enables managing of XEN Server as a Compute Resource in Foreman.


Packages are available for Debian based distribtions as ruby-foreman-xen and for Red Hat based distributions as ruby193-rubygem-foreman_xen The gem name is foreman_xen.

Please see the Foreman manual for further instructions:

Image based provisioning

In order to use the cloud-init functionality users need to:

  • install the genisoimage package
  • mount a "NFS ISO Library" (as XenServer calls it) which is attached to the Xen pool to a location writable by the foreman user.
  • set this mount point / path as ISO library mountpoint in the compute resource

foreman_xen then creates a network configuration file, renders the user_data template, puts them in an ISO, copies this ISO to the attached ISO-library and attaches it to the created VM, where cloud-init can use the data provided to initialize the VM.


Foreman Version Plugin Version
>=1.5, <1.8 0.0.x (unmaintained)
>=1.8.1, <1.10 0.1.x (unmaintained)
>=1.10, <1.11 0.2.x (unmaintained)
>=1.11, <1.13 0.3.x (unmaintained)
>=1.13, <1.14 0.4.x (unmaintained)
>=1.14, <1.17 0.5.x (unmaintained)
>=1.17, <1.18 0.6.x (unmaintained)
>=1.18, <1.20 0.7.x (unmaintained)
>=1.20 1.0.0



Copyright (c) 2014 ooVoo LLC

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see