TrueNAS CORE Nightly Development DocumentationThis content follows experimental early release software. Use the Product and Version selectors above to view content specific to a stable software release.
Jails Screens
14 minute read.
Last Modified 2024-03-15 13:24 EDTAs of TrueNAS CORE 13.3, this feature is untested and provided without support to the TrueNAS Community.
Users with a critical need to use containers or virtualization solutions in production should migrate to the tested and supported virtualization features available in TrueNAS SCALE. TrueNAS Enterprise customers can contact iXsystems to schedule a TrueNAS SCALE deployment. See CORE to SCALE Migrations for more information.
The Jails screen displays a list of jails installed on your system. Use to add, edit or delete jails.
Use the blue Columns dropdown list to display options to change the information displayed in the list of tables. Options are Select All, JID, Boot, State, Release, IPv4, IPv6, Type, Template, Basejail or Reset to Defaults.
Use the
icon to set the pool to use for jail storage.Use ADD to display the first configuration Wizard screen and to access the ADVANCED JAIL CREATION button to display advanced jail configuration screens.
Click the
icon to display the individual jail screen, the primary settings and additional action options for that jail.Click the
icon to collapse the individual jail screen.Name | Description |
---|---|
EDIT | Used to modify the settings described in Advanced Jail Creation below. You cannot edit a jail while it is running. You can only view read only settings until you stop the jail operation. |
MOUNT POINTS | Select an existing mount point to edit. Either click EDIT or ACTIONS > Add Mount Point to create a mount point for the jail. A mount point gives a jail access to storage located elsewhere on the system. You must stop a jail before adding, editing, or deleting a mount point. |
RESTART | Stops and immediately starts a jail that is running or up. |
START | Starts a jail that has a current STATE of down. |
STOP | Stops a jail in the current STATE of up. |
UPDATE | Runs freebsd-update to update the jail to the latest patch level of the installed FreeBSD release. |
SHELL | Displays the Shell screen with access to a root command prompt where you can interact with a jail directly from the command line. Type exit to leave the command prompt or click Jails on the breadcrumb at the top of the screen to return to the Jails screen. |
DELETE | Deletes the selected jail. Caution: deleting the jail also deletes all of the jail contents and all associated snapshots. Back up the jail data, configuration, and programs first. There is no way to recover the contents of a jail after deleting it! |
Action options change based on the jail state. For example, a stopped jail does not have a STOP or SHELL option.
TrueNAS has two options to create a jail, the Wizard or the Advanced Jail Creation option at the bottom of the Wizard screen. The Jail Wizard makes it easy to create a jail. ADVANCED JAIL CREATION opens the advanced configuration screen with all possible jail configuration settings. We recommend that only advanced users with specific requirements for a jail use this form.