Skip to content
FreeNAS Git Repository
Python Shell JavaScript HTML Makefile CSS Other
Find file
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


FreeNAS 8.x is a complete different software compared to 0.7. There is a
complete feature parity between 0.7 (legacy) and 8.x with plugins, there
are also some features in 8.x that aren't available in 0.7.
There isn't an upgrade path from 0.7 to 8.x.

To build the system (experts only):


- Your build environment must be FreeBSD 8.1-RELEASE or newer.
- amd64 or i386 for i386 builds; an amd64 for amd64 builds.
- You will need the following ports/packages when compiling anything
  - devel/git-subversion
  - lang/python26 or lang/python27

- You need the following additional ports/packages to build the FreeNAS base
  OS image:
  - sysutils/cdrtools

- You need the following additional ports/packages to build the plugins jail:
  - ports-mgmt/pbi-manager

- The port security/sudo is recommended but not required, if you do not have
  the port installed you can run the commands listed in this doc as root.

- If you have the devel/gamin port installed, you may encounter errors
  during the FreeNAS build when it tries to unmount nullfs file systems.
  To fix this, you either can remove the port, or create a config file
  /usr/local/etc/gamin/gaminrc with the following entries to disable gamin
  notifications on certain file systems:

    fsset nullfs none
    fsset ufs none
    fsset zfs none

  See: for more details.

Building the System Quickstart Flow:

- Checking out the code from git:

% git clone --depth 1 git://
% cd freenas

- Use the build script

% sudo sh build/

This will fetch TrueOS and ports for the build. However it is recommended that you maintain a local git mirror to speed up further builds:

% git clone git:// ${HOME}/ports
% git clone git:// ${HOME}/trueos

To build using those local mirrors run:

% sudo env GIT_REPO=${HOME}/trueos GIT_PORTS_REPO=${HOME}/ports sh build/

That's it.

The End Result:

If your build completes successfully, you'll have an image in
obj.yyyy/FreeNAS-VVVV-XXXX-yyyy.img.xz where:

- VVVV is the 'release' branch version or.
- XXXX is the git commit hash from the FreeNAS repo.
- yyyy is either i386 or amd64 depending on your platform and what was
  provided via $FREENAS_ARCH on the command line / via the environment.

This is a compressed raw disk image, and needs to be decompressed and
converted to your favorite VM container format before use, flashed on to a USB
key fob, etc.  There will also be a CD/DVD image,
obj.yyyy/FreeNAS-VVVV-XXXX-yyyy.iso, that you can use to install/upgrade

Common workflows:

1. Building an i386 on an amd64 build server:

% sudo env FREENAS_ARCH=i386 sh build/

2. Forcing an source / ports update:

% sudo sh build/ -u

3. Updating ports patches:

% sudo rm -Rf os-base/$FREENAS_ARCH/ports/packages/
% sudo sh build/ -u

NOTE: when things get smarter (and they will.. the developers feel your pain
too :/..), nuking individual packages won't be required; this will require
fiddling around with the ports infrastructure, which is a semi-large
undertaking. Thus, I wouldn't expect this to be enhanced anytime soon :(..
(but it's annoyed the author of this document enough that it's time to fix
things properly!).

4. Update source and ports, patch, and rebuild FreeBSD:

% sudo sh build/ -fu

5. Force a build from scratch (nukes packages, rebuild FreeBSD):

% sudo sh build/ -ff

6. Build everything required (src, ports) but don't produce GUI upgrade/CD

% sudo sh build/ -- -i

Submitting Build Bugs:

Please execute the 'build/' command and follow the directions
described by the script.
Something went wrong with that request. Please try again.