diff options
| author | Alfredo Cruz <alfredo.carlon@gmail.com> | 2026-06-23 14:48:30 +0000 |
|---|---|---|
| committer | Benedict Reuschling <bcr@FreeBSD.org> | 2026-06-23 14:58:56 +0000 |
| commit | 9dfeda70dd59b61f43455b76afed50a6d52d9ced (patch) | |
| tree | 135f7b20dbf008d8d7179dda8737497d0db474e6 | |
| parent | 01bfc34871146e3de912efc4afe374393d265417 (diff) | |
handbook/jails: Small fixes to the Linux jail section
- Add missing containers/ path in one instance
- Move the jail.conf creation to the beginning of this section (slightly
modified from the original patch), because it fits better there
instead of letting the reader know about it when starting the jail
- Use sh as the shell executed when running jexec to ensure it is a jail
that is present in Linux
- Rephrase a sentence to avoid a comma and instead use "and" to connect
the two packages to install (also modified from the original
submission)
Event: Halifax Hackathon 202606
PR: 295777
Differential Revision: https://reviews.freebsd.org/D57771
| -rw-r--r-- | documentation/content/en/books/handbook/jails/_index.adoc | 13 |
1 files changed, 10 insertions, 3 deletions
diff --git a/documentation/content/en/books/handbook/jails/_index.adoc b/documentation/content/en/books/handbook/jails/_index.adoc index f3e6eef17f..49f38720b2 100644 --- a/documentation/content/en/books/handbook/jails/_index.adoc +++ b/documentation/content/en/books/handbook/jails/_index.adoc @@ -818,6 +818,13 @@ The next step will be to create a jail as indicated above, for example in crossref:jails[creating-thin-jail-openzfs-snapshots, Creating a Thin Jail Using OpenZFS Snapshots], but *without* performing the configuration. FreeBSD Linux jails require a specific configuration that will be detailed below. +Create an empty [.filename]#/etc/jail.conf# to prevent failures when trying to stop the jail: + +[source,shell] +.... +# touch /etc/jail.conf +.... + Once the jail has been created as explained above, execute the following command to perform required configuration for the jail and start it: [source,shell] @@ -825,7 +832,7 @@ Once the jail has been created as explained above, execute the following command # jail -cm \ name=ubuntu \ host.hostname="ubuntu.example.com" \ - path="/usr/local/jails/ubuntu" \ + path="/usr/local/jails/containers/ubuntu" \ interface="em0" \ ip4.addr="192.168.1.150" \ exec.start="/bin/sh /etc/rc" \ @@ -848,10 +855,10 @@ Execute the following command to access the FreeBSD Linux jail: [source,shell] .... -# jexec -u root ubuntu +# jexec -u root ubuntu sh .... -Inside the jail, execute the following commands to install package:sysutils/debootstrap[] and prepare the Ubuntu environment: +Inside the jail, execute the following commands to install man:pkg[7] and package:sysutils/debootstrap[] to prepare the Ubuntu environment: [source,shell] .... |