Introduction

Phenix is build nightly through an automated bootstrap mechanism. This procedure is very lengthy and only available to authorised Phenix developers. If you have a recent existing installation of Phenix and wish to recompile the sources on your own machine a quicker procedure exists. You do not have to be a Phenix developer either. This document describes how to build Phenix from the sources in your installation without using bootstrap.py. It applies to both Linux and MacOSX. Links to Windows build is included.

Build procedure

Assuming your installation is located in /path/to/my/phenix/ change directory from a Bash shell to /path/to/my/phenix/build. Then from that Bash shell and in that directory run the commands:

shopt -s extglob
rm -- !(config_modules.sh)

This has the effect of deleting all files and directories from the build directory except for the config_modules.sh file. Now within the /path/to/my/phenix/build directory run the command:

./config_modules.sh

This will prepare the build of Phenix using the python and necessary base components shipped with your Phenix installation. Then run the commands:

source setpaths.sh
libtbx.scons -j nproc

where nproc is the number of cpu cores you want to use for the build. The build should take less than an hour on a modern multicore PC.

Windows Build

The above procedure is much the same for building on Windows systems. Click here for further details.