Manage and create FreeBSD jails

Thomas Bartelmess



8,751 latest version

3.0 quality score

Version information

  • 0.1.5 (latest)
  • 0.1.4
  • 0.1.3
  • 0.1.2
  • 0.1.1
  • 0.1.0
released Jan 1st 2015
This version is compatible with:
  • Puppet 3.5
  • FreeBSD

Start using this module


tbartelmess/jail — version 0.1.5 Jan 1st 2015


Build Status

Table of Contents

  1. Overview
  2. Module Description - What the module does and why it is useful
  3. Beginning with jail
  4. Usage - Configuration options and additional functionality
  5. Limitations - OS compatibility, etc.


This module creates and manages FreeBSD jails.

Module Description


Beginning with jail

This module creates and manages FreeBSD jails. It is possible to create simple jails and use them as seperate systems. The module also allows to generate ezjail style basejails. Basejails are like templates for other jails, that allow to not duplicate the system data.


Setting up the host

include jail

Create a jail

Create basic jail

A basic jail will download FreeBSD from the FreeBSD FTP servers.

jail::jail {'myjail':


Create a base jail and 2 jails

jail::jail {'mybase':
jail::jail {'jail1:
  hostname => "jail1.example.com"
  basejail => "mybase"
jail::jail {'jail2:
  hostname => "jail2.example.com"
  basejail => "mybase"


At this point only FreeBSD 10 is supported. Older versions of FreeBSD might work, however the installation of puppet within the jail uses the pkg(8) utility.