yurkis / trueos Goto Github PK

This is the top level TrueOS source directory. It is more or less a fork of FreeBSD.

In what ways does TrueOS differ from stock FreeBSD you may be wondering? Read on for a list of the distinctions in no particular order:

• Bi-Annual Release Cycle - TrueOS follows traditional FreeBSD HEAD and cuts new releases on a 6 months schedule which includes OS and Ports.

• GitHub - TrueOS uses Git/GitHub as the "Source of truth", Pull-Requests welcome!

• CI - Our Jenkins build cluster is constantly building new versions of TrueOS for testing.

• dhcpcd - dhcpcd has been integrated directly into base, allowing more advanced IPv4 and IPv6 network configuration

• OpenRC - This replaces the legacy rc.d scripts with OpenRC's init.d subsystem, allowing faster boots, as well as a host of other service improvements.

• Package Base - TrueOS is installed and based on using Packages for the Base OS.

• Root NSS Certs - Since it really is a bummer to not be able to use HTTPS out of box...

• Custom Installer - TrueOS includes its own pc-sysinstall installation system, along with text-based front-end. This allows a wide variety of ZFS-based installation options, as well as scriptability.

• JSON Build Manifest - TrueOS supports a customizable JSON manifest for building. This allows TrueOS to run poudriere and assemble installation images for a variety of use-cases.

• Single repo - Base packages and ports now share a single repository which allows base packages to depend upon ports, such as jq for -devel packages

• More as they come...

The following instructions may be used to generate TrueOS installation images:

make buildworld buildkernel
make packages
cd release && make iso

If you want to re-use the base packages and just re-run port builds, you may do so with:

make ports

To change the default manifest from CI to something else, set the TRUEOS_MANIFEST variable to the full path. I.E:

# setenv TRUEOS_MANIFEST /usr/src/release/manifests/trueos-master.json
# make buildworld buildkernel
 ...

Since TrueOS uses an external toolchain, an additional step is required before using stock Poudriere. This is to install the base pkg environment and boot-strap the external compiler. To create a Poudriere jail on TrueOS, run the following command assuming you have poudriere-trueos installed:

poudriere jail -c -j trueos -m trueos -v 13.0

Checkout the portstree with git.

poudriere ports -c -p default -m git -U https://github.com/trueos/trueos-ports -B trueos-master

and to update jail to the latest trueos snapshot you can use

poudriere jail -u -j trueos