Sorry for the inconvenience.  Chance of typos in templates, the navigation header should be functional for most versions of the handbook.
Potential remains for unforeseen breakage primarily in the handbook portion of the wiki.
Notice will be up until above verified and no other troubles found from recent modifications.

Using the PBI Builder

From PC-BSD Wiki
Revision as of 12:34, 20 January 2009 by Krismoore (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Using the PBI Builder Software

This guide is intended to instruct developers, or simply the curious, on how to use the PBI Builder software, which compiles a FreeBSD port, and turns it into a fully-functional PBI file.


Installing the PBI Builder software relatively easy, simply download the tbz package from the [PBI Builder Homepage], and place it somewhere on your system with several GB of free space. Next run these commands (as root):

  # tar xvjpf pbibuild*.tbz
  # ln -s `pwd`/pbi-build /pbi-build

Note: On regular FreeBSD systems, you will need to install "bash" for the builder to function, and link it to /bin/bash. This step is not required on PC-BSD.

 # pkg_add -r bash
 # ln -s /usr/local/bin/bash /bin/bash 

Usage Instructions

Using the PBI builder to convert a port into a PBI is very simple. First, you will need to copy a module directory into the /pbi-build/modules directory. Several examples are provided in /pbi-build/docs/module-examples, or you may copy a module from our [subversion repository]. After you have done this, simply run these commands:

 # cd /pbi-build
 # ./ 

The first time you run the script, it will connect to CVS and download a copy of the ports tree. You may change the cvsup server it uses by editing /pbi-build/conf/ports-supfile. If you wish to update your ports tree, simply run "/pbi-build/cron/". This script may be run from cron to ensure that your ports tree is always up to date.

Personal tools