Skip to content

BUILD.md

Latest commit

 

History

History
89 lines (63 loc) · 2.57 KB

BUILD.md

File metadata and controls

89 lines (63 loc) · 2.57 KB

mfsBSD building instructions

Copyright (c) 2019 Martin Matuska

Configuration

Read hints in the sample configuration files in the conf/ directory, copy these files to files without .sample ending and make modifications to suit your needs.

The default root password is mfsroot. You can pick a different password with the ROOTPW or ROOTPW_HASH make variables.

This password can be used to log in as root over SSH.

To disable remote root login, pass PERMIT_ROOT_LOGIN=no to make.

To disallow password authentication for root, set PERMIT_ROOT_LOGIN=without-password. If you do so, remember to add your SSH keys to conf/authorized_keys if you want to be able to log in via SSH.

Additional packages and files

If you want any packages installed, copy the package archives, e.g., .txz files, that should be automatically installed into the packages/ directory.

Add any additional files into the customfiles/ directory. These will be copied recursively into the root of the boot image.

WARNING: Your image size may not exceed MFSROOT_MAXSIZE. Please adjust the value as needed for larger images.

Distribution or custom world and kernel

You may choose to build from a FreeBSD distribution e.g. CDROM, or by using make buildworld / make buildkernel using a custom world and kernel configuration.

To use a distribution, e.g. FreeBSD CDROM, you need access to it, e.g. mount the FreeBSD ISO via mdconfig, etc, and specify BASE=/path/to/distribution when invoking make.

To use your own but already built world and kernel, use CUSTOM=1.

If you want this script to do make buildworld and make buildkernel for you, specify the BUILDWORLD=1 and BUILDKERNEL=1 variables to make, respectively.

Examples

  1. Disk image
make BASE=/cdrom/usr/freebsd-dist
make BASE=/cdrom/10.2-RELEASE
make CUSTOM=1 BUILDWORLD=1 BUILDKERNEL=1
  1. Bootable ISO file:
make iso BASE=/cdrom/usr/freebsd-dist
make iso BASE=/cdrom/10.2-RELEASE
make iso CUSTOM=1 BUILDWORLD=1 BUILDKERNEL=1
  1. .tar.gz file:
make tar BASE=/cdrom/usr/freebsd-dist
make tar BASE=/cdrom/10.2-RELEASE
make tar CUSTOM=1 BUILDWORLD=1 BUILDKERNEL=1
  1. roothack edition:
make iso CUSTOM=1 BUILDWORLD=1 BUILDKERNEL=1 ROOTHACK=1
  1. Custom release edition, i.e., using a FreeBSD release distribution:
make iso BASE=/cdrom/11.0-RELEASE RELEASE=11.0-RELEASE TARGET=amd64
  1. GCE-compatible .tar.gz file:
make gce BASE=/cdrom/11.0-RELEASE
make gce CUSTOM=1 BUILDWORLD=1 BUILDKERNEL=1