poudriere image.8

This page is auto-generated from src/bin/poudriere-image.8

POUDRIERE-IMAGE(8)

FreeBSD System Manager's Manual

POUDRIERE-IMAGE(8)

NAME

poudriere-image — build OS filesystem images

SYNOPSIS

poudriere

[poudriere-options] image [options]

DESCRIPTION

Builds a filesystem image per the specified options.

WARNING: This feature is still considered ALPHA.

OPTIONS

-c overlaydir

This specifies an extra directory whose contents will be copied directly into the final image, starting from the root.

-f packagelist

This specifies a list of packages to be pre-installed in the final image.

-h hostname

This specifies the hostname used for the image. Defaults to poudriere-image.

-j name

This argument specifies the name of the jail that is used.

-m overlaydir

Build a miniroot image as well (for tar type images), and copy this directory into the miniroot image.

-n name

This specifies the name of the resulting image.

-o outputdir

This argument specifies directory where the resulting image will be created.

-p tree

This argument specifies the name of the ports tree that is used.

-s size

This specifies the maximum size of the image that is built.

-t type

This specifies the type of image to create:

iso

An ISO 9660 format image.

iso+mfs

An ISO 9660 format image where the root filesystem is MFS mounted.

iso+zmfs

An ISO 9660 format image where the root filesystem is LZ77 compressed and is MFS mounted.

usb

A GPT-layout prepared UFS2 image containing a UEFI boot loader.

usb+mfs

A GPT-layout prepared UFS2 image containing a UEFI boot loader where the root filesystem is MFS mounted.

usb+zmfs

A GPT-layout prepared UFS2 image containing a UEFI boot loader where the root filesystem is LZ77 compressed and is MFS mounted.

rawdisk

A raw UFS2, softupdates-enabled, disk image.

zrawdisk

A raw ZFS disk image.

tar

An XZ-compressed tarball.

firmware

A NanoBSD style image with a GPT partitions and a UEFI boot loader.

rawfirmware

A raw disk image.

embedded

Create a u-boot ready embedded image.

-X excludefile

This specifies a list of files to exclude from the final image.

-z set

This specifies which SET to use for the build.

SEE ALSO

poudriere(8), poudriere-bulk(8), poudriere-distclean(8), poudriere-jail(8), poudriere-logclean(8), poudriere-options(8), poudriere-pkgclean(8), poudriere-ports(8), poudriere-queue(8), poudriere-status(8), poudriere-testport(8), poudriere-version(8)

AUTHORS

Baptiste Daroussin ⟨bapt@FreeBSD.org⟩
Bryan Drewery ⟨bdrewery@FreeBSD.org⟩

March 8, 2018

FreeBSD 14.0-CURRENT