The Handbook

    Theme
    • Guides
        • Check a system before installing FreeBSD
        • Orient a Linux administrator on FreeBSD
        • Supported FreeBSD releases
        • Choose a FreeBSD documentation and support channel
        • Move files safely without GNU mv -t
        • Update, upgrade, or update packages?
        • Upgrade 14.4 or 15.0 to FreeBSD 15.1
        • Choose packages, ports, or poudriere
        • Choose the quarterly or latest package branch
        • Choose a FreeBSD download or package mirror
        • Make a system setting persistent
        • Configure locale, keyboard, and time zone
        • Configure a serial console for recovery
        • Choose a custom kernel, module, or loader setting
        • Run a Linux binary with the compatibility layer
        • Check desktop and laptop hardware before installation
        • Choose and check a graphics driver
        • Choose Xorg or Wayland
        • Build a maintainable desktop baseline
        • Install and check a desktop browser
        • Check laptop Wi-Fi, power, and suspend
        • Check multimedia readiness
        • Choose and configure a printing stack
        • Run Windows applications with Wine
        • Snapshot and replicate a ZFS dataset
        • Choose a filesystem and storage layout
        • Operate ZFS without losing the recovery path
        • Restore files from a ZFS snapshot
        • Read ZFS pool health and run a scrub
        • Replace a failed device in a ZFS mirror
        • Replicate a ZFS dataset over SSH
        • Change PF safely on a remote host
        • Configure a narrow WireGuard tunnel
        • Plan a FreeBSD home server
        • Choose a mail server or an outgoing relay
        • Publish a network service safely
        • Choose a jail network model
        • Choose native jails or a jail manager
        • Choose a jail or a bhyve virtual machine
        • Establish a FreeBSD security baseline
        • Choose a MAC policy
        • Audit security-relevant activity
        • Start a DTrace performance investigation
    • Integrations
        • Create a first jail with Bastille
        • Compare jail managers and OCI tooling
        • Publish a Bastille service through PF
        • Mount a ZFS dataset in a Bastille jail
        • Update and upgrade Bastille jails
        • Back up and restore a Bastille jail
        • Prepare bhyve and vm-bhyve
        • Choose NFS or Samba for file sharing
        • Choose ZFS backup automation
        • Operate a signed poudriere repository
        • Manage FreeBSD configuration with Ansible or Salt
        • Run Motion with webcamd on FreeBSD
        • Design a reverse proxy, certificates, and monitoring
    • FAQ
      • Troubleshooting
          • Recover an interrupted freebsd-update run
          • Resolve a package repository or ABI mismatch
          • Diagnose the FreeBSD boot path
          • Recover with a ZFS boot environment
          • Diagnose DNS, routing, and firewall paths
          • Diagnose network mbuf exhaustion
          • Bind a service to a low port without running it as root
          • Diagnose audio output or input
          • Diagnose webcamd, cuse, and a webcam
          • Fix USB device permissions without opening every device
      • About this handbook
      • Synopsis
      • Compare the operating model
      • Match the tool to the constraint
      • Run a proof before adoption
      • Primary references

      Compare jail managers and OCI tooling

      Last reviewed
      13 August 2026
      Applies to
      15.1-RELEASE, 15.0-RELEASE, 14.4-RELEASE

      Synopsis #

      FreeBSD jail managers are not interchangeable front ends. Some focus on transparent host administration, some on application images and orchestration, and some manage both jails and virtual machines. OCI tooling is another distribution and workflow layer over jail technology, not a replacement kernel-isolation model.

      This comparison records verifiable project scope and maintenance signals as of the review date. It does not rank projects by popularity. Confirm current packages, release support, open issues, backup behavior, and upgrade documentation before adoption.

      Compare the operating model #

      ApproachDistinctive scopeSuitable whenCurrent maintenance signal
      Native jail.confBase-system configuration, service jails, VNET, ZFS, and resource controlsA small visible local policy is preferable to another abstractionMaintained as part of FreeBSD; service jails and zfs.dataset integration expanded in 15.x
      BastilleRelease management, several network modes, templates, mounts, export/import, and migrationConventional jails need a coherent host-oriented lifecycleRelease 1.4.4 published July 2026; current documentation uses FreeBSD 15.1
      AppJailMakejails, Director multi-jail definitions, VNET/NAT, pkgbase, OCI and Linux-jail workApplication definitions and active orchestration development are primary requirementsActive 2025 and 2026 FreeBSD status reports and current upstream documentation
      pot and PotluckJail images or flavors plus Nomad-oriented orchestration and a public catalogueRepeatable application images and clustered scheduling are requiredpot 0.16.1 reported in 2025; current project material points to the maintained pot and Potluck sites
      CBSDBroad jail and bhyve management, images, networking, storage, and multi-node facilitiesOne operations platform must cover jails and virtual machinesActive upstream repository and FreeBSD port; much broader configuration surface than a jail-only tool
      iocageZFS-centered jail management, properties, snapshots, and an established installed baseExisting iocage estates need continued operation or migrationStewardship and source are under the FreeBSD organization; port 1.13 was updated in June 2026
      Podman and FreeBSD OCI imagesOCI image naming, distribution, building, and runtime workflow over jailsOCI-compatible build and registry workflows are requiredOfficial FreeBSD OCI images and a dedicated current Handbook chapter; Podman containers presently run as root

      The table describes scope, not security equivalence. Every entry ultimately relies on host kernel, storage, network, and firewall controls.

      Match the tool to the constraint #

      Choose native configuration or Bastille when direct host visibility and a modest number of service jails matter most. Evaluate AppJail when Makejail and Director workflows match the intended deployment model. Evaluate pot and Potluck when images and Nomad-style scheduling are actual requirements. Evaluate CBSD when bhyve and multi-node operations justify its larger surface.

      Treat iocage as a current maintained option, especially for existing estates. Do not begin a migration based on old claims that the project is abandoned; inspect the FreeBSD organization repository and current port. Conversely, an available package alone does not prove that a particular historic workflow is safe on the target release.

      Choose OCI tooling for OCI interoperability, not because the word container implies Linux kernel behavior. FreeBSD OCI containers use jails and the FreeBSD kernel. Linux application expectations still require compatibility analysis.

      Run a proof before adoption #

      Test the candidate against the complete lifecycle:

      1. Create a jail from an auditable release source.
      2. Apply base and package updates.
      3. Configure the required network model and expose one service.
      4. Attach and back up persistent data.
      5. Export or migrate the jail to a clean host.
      6. Upgrade it to the next supported FreeBSD release.
      7. Recover without relying on state that was not in the backup.
      8. Explain the resulting host state with base tools.

      For the architectural choice preceding this comparison, see Choose native jails or a jail manager . The implemented Bastille path begins with Create a first jail with Bastille .

      Primary references #

      • FreeBSD Handbook: Jail managers and containers
      • Bastille release history
      • AppJail documentation
      • FreeBSD 2026Q1 AppJail status report
      • FreeBSD pot, Potluck, and Potman status report
      • CBSD upstream repository
      • iocage upstream repository
      • FreeBSD Handbook: OCI Containers

      Independent documentation. Not affiliated with or endorsed by the FreeBSD Project or the FreeBSD Foundation.

      Report a bug
      • Synopsis
      • Compare the operating model
      • Match the tool to the constraint
      • Run a proof before adoption
      • Primary references