FreeBSD Manual Pages
bastille-create(8) System Manager's Manual bastille-create(8) NAME bastille create -- Create a jail. SYNOPSIS bastille [-BCDELMPTVvx] [-g IP] [-n IP,IP] [-p VALUE] [-v VALUE] [-Z VALUE] [--no-boot] [--no-ip] [--no-validate] NAME RELEASE IP [INTERFACE] DESCRIPTION The bastille sub-command is used to create a jail with any of the given op- tions. The INTERFACE value is only optional for classic/standard jails. For any type of VNET jail, it is mandatory. -B, --bridge Enable VNET. INTERFACE must be a bridge. This option is for use with manually created bridges. -C, --clone Create a clone jail (ZFS only). These are simply zfs clones of the release. -D, --dual Use dual (IPv4+6) networking (IP=[inherit|ip_hostname] only). This option is only supported for non-VNET jails. -E, --empty Create an empty jail (NAME only). This option will only create the jail structure and config, but the root will be empty. -g IP, --gateway IP Specify a default router/gateway. Bastille normally detects your gateway from your host. Set this option to override it. -L, --linux Create a Linux jail (experimental). -M, --static-mac Use a static/persistent MAC address (VNET only). -n IP,IP --nameserver IP,IP Specify nameserver(s) for the jail. Comma-separated. --no-boot Set boot=off. By default, jails are created with 'boot=on' so as to start on sys- tem startup. --no-ip Create jail without an ip (VNET only). --no-validate Do not validate the release name. By default, Bastille will attempt to validate the release name against a known index of official release names. Set this option to bypass that. Useful in the case of an unknown release, or releases create using 'bastille convert'. See bastille-convert(8). -P, --passthrough Enable VNET. INTERFACE is used as-is. This will pass the entire INTERFACE into the jail, which will make it unusable to the host until the jail is stopped. -p VALUE, --priority VALUE Set priority value. This controls the order in which jails start and stop on system startup and shutdown. It also controls the order in which any sub- command is executed when multiple jails are tarteted. --tags TAG1,TAG2 Apply specified tag(s) to jail. Comma-separated. -T, --thick Create a thick jail. Thick jails are complete copies of the release. -V, --vnet Enable VNET. INTERFACE must be a physical interface. This option is for use with a physical interface. Bridging and epairs are handled by the 'jib' script. -v VALUE, --vlan VALUE Set VLAN ID (VNET only). This will configure the jail to use the specified VALUE as the VLAN ID. -x, --debug Enable debug mode. -Z VALUE,VALUE, --zfs-opts VALUE,VALUE Custom zfs options. Comma-separated. Comma separated list of ZFS options to create the jail with. This overrides the defaults. See bastille.conf(5). EXAMPLES Create a thick jail, with static MAC and priority 10: bastille create -TM -p 10 myjail 15.0-RELEASE 10.23.23.1 Create a VNET jail attached to a manual bridge: bastille create -B myjail 15.0-RELEASE DHCP mycustombridge Create a Linux jail: bastille create -L myjail bookworm 10.2.4.5 Create a VNET jail with boot=off and custom gateway: bastille create -V --no-boot -g 10.1.1.1 myjail 15.0-RELEASE 10.1.1.4/24 vtnet0 In the above examples, sometimes an INTERFACE is specified, and sometimes it is not. It is ONLY optional for classic/standard jails. See the 'Networking' section in bastille.conf(5). SEE ALSO bastille.conf(5), bastille-bootstrap(8), bastille-clone(8), bastille- cmd(8), bastille-config(8), bastille-console(8), bastille-convert(8), bastille-cp(8), bastille-destroy(8), bastille-edit(8), bastille-etcup- date(8), bastille-export(8), bastille-htop(8), bastille-import(8), bastille-jcp(8), bastille-limits(8), bastille-list(8), bastille-migrate(8), bastille-monitor(8), bastille-mount(8), bastille-network(8), bastille- pkg(8), bastille-rcp(8), bastille-rdr(8), bastille-rename(8), bastille- restart(8), bastille-service(8), bastille-setup(8), bastille-start(8), bastille-stop(8), bastille-sysrc(8), bastille-tags(8), bastille-tem- plate(8), bastille-top(8), bastille-umount(8), bastille-update(8), bastille-upgrade(8), bastille-verify(8), bastille-zfs(8) FreeBSD ports 15.quarterly December 6, 2025 bastille-create(8)
NAME | SYNOPSIS | DESCRIPTION | EXAMPLES | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=bastille-create&sektion=8&manpath=FreeBSD+Ports+15.1.quarterly>