Bug 263330

Summary: Extend the FreeBSD Handbook jails section to mention iocage
Product: Documentation Reporter: Pau Amma <pauamma>
Component: Books & ArticlesAssignee: Sergio Carlavilla Delgado <carlavilla>
Status: Closed Not Accepted    
Severity: Affects Some People CC: doc
Priority: ---    
Version: Latest   
Hardware: Any   
OS: Any   
URL: https://docs.freebsd.org/en/books/handbook/jails/#jails-ezjail
See Also: https://reviews.freebsd.org/D41450
Bug Depends on:    
Bug Blocks: 263315    

Description Pau Amma 2022-04-16 12:00:07 UTC
Maybe remove ezjail while there. Either way, make sure anchor matches and adjust it if needed elsewhere in doc and in the wiki.
Comment 1 Sergio Carlavilla Delgado freebsd_committer freebsd_triage 2023-08-29 20:13:10 UTC
I'm gonna close this since there's a WIP of this chapter and the idea is to don't mention any jail manager in the Handbook, only a table at the end of the chapter with a couple of them.
Comment 2 commit-hook freebsd_committer freebsd_triage 2023-09-20 08:34:06 UTC
A commit in branch main references this bug:

URL: https://cgit.FreeBSD.org/doc/commit/?id=612b7cc1721224c494c5b2600188e1508bb5611b

commit 612b7cc1721224c494c5b2600188e1508bb5611b
Author:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
AuthorDate: 2023-09-20 08:15:40 +0000
Commit:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
CommitDate: 2023-09-20 08:15:40 +0000

    Handbook - Jails: Rewrite the chapter

    Changes:
    - Add jail types info: Thick, Thin, VNET and Linux Jails
    - Add info about the necessary configuration on the host system
    - Add info about types of networking in the jails
    - Explain the jail config file
    - Add info about how to configure Thick, Thin, VNET and Linux Jails
    - Explain how to upgrade the different types of jails
    - Add info about the resources limits in a Jail
    - Add info about different jail managers and containers

    Information obtained from:
    - https://man.freebsd.org/cgi/man.cgi?query=jail&sektion=8
    - https://wiki.freebsd.org/Jails
    - https://man.freebsd.org/cgi/man.cgi?rctl(8)
    - https://vermaden.wordpress.com/2023/06/28/freebsd-jails-containers/
    - https://clinta.github.io/freebsd-jails-the-hard-way/
    - https://jacob.ludriks.com/2017/06/07/FreeBSD-Thin-Jails/
    - Jails and VNET a guide - Derik J. Ramirez
    - https://wb-hk.blogspot.com/2016/04/freebsd-jails-4-thin-jails-using-nullfs.html
    - https://blog.uidrafter.com/freebsd-jails-network-setup
    - https://forums.freebsd.org/threads/setting-up-a-debian-linux-jail-on-freebsd.68434/
    - https://github.com/msimerson/Mail-Toaster-6/wiki/Linux-Jails
    - https://etherealwake.com/2021/08/freebsd-jail-networking/
    - https://wiki.freebsd.org/TomMarcoen/JailNetworking
    - https://weblog.antranigv.am/posts/2020/06/vnet-jail-howto/

    PR:                     203641, 200905, 209157, 248150, 263330, 264317,
                            226282, 239861, 166358, 178221, 265410
    Reviewed by:            karels@, fernape@, jrm@
    Differential Revision:  https://reviews.freebsd.org/D41450

 .../content/en/books/handbook/jails/_index.adoc    | 1492 ++++++++++----------
 1 file changed, 715 insertions(+), 777 deletions(-)