Tinderbox User Guide

Tinderbox is a package building system for FreeBSD ports, based on official Portbuild scripts used on pointyhat building cluster. Tinderbox was written by Joe Marcus Clarke.

You can define multiple jails (base system versions) and multiple portstrees. The combination of jail and portstree is called a build. A Tinderbox jail is not what is understood as a jail in FreeBSD, it is in fact a given world in a chroot. Tinderbox supports automatic tracking of dependencies and only rebuilds packages that changed since last run. Tinderbox has support for email notification of failed builds. Tinderbox also integrates well with ccache.

Tinderbox is designed to easily provide package sets of ports you need, for platforms and architectures you need. Tinderbox is also excellent tool for testing new ports and port upgrades, especially for testing dependencies and packing lists. It's also useful for testing ports on various releases of FreeBSD, since you can run FreeBSD 8.X/9.X world as a jail on a FreeBSD 10.X host.


Table of Contents
1 Obtaining Tinderbox
2 Requirements
3 Installation
4 Upgrading
5 Using Tinderbox
6 Maintenance
7 Troubleshooting
8 Advanced Topics
8.1 Alternative Means of Creating Jail Sources and PortsTrees
8.2 Alternative Mounting
8.3 Distfile Caching
8.4 Using Ccache
8.5 Customizing the Environment
8.6 Updating port properties
8.7 Configuring port OPTIONS
8.8 Using Hooks
8.9 Creating Users
8.10 Automating/Queuing Port Builds
8.11 Running Tinderbox in a Jail
8.12 Mounting ${pb} over NFS
8.13 Cross-compiling ports
A. Contributed Articles / Further Reading
A.1 Using FreeBSD's Tinderbox as a package builder
List of Tables
5-1. configLog Options
5-2. tinderbuild Commands
6-1. copyBuild Options
6-2. tbcleanup Options
8-1. configCcache Options
8-2. configOptions arguments