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 options. 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 system 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-etcupdate(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-template(8), bastille-top(8), bastille-umount(8), bastille-update(8), bastille-upgrade(8), bastille-verify(8), bastille-zfs(8)