Setting up a ProteanOS Package Development Environment

← Back to Package Development Tutorials

This guide will explain how to set up a ProteanOS development system for building software packages under chroot(8).

Note that to run ProteanOS under chroot(8) you need a system running Linux 3.4 or later. These instructions have been tested on a Debian GNU/Linux 7.0 (wheezy) system with Linux 3.12 from wheezy-backports.

The ProteanOS Development Kit uses the chroot(8) and mount(8) commands, which on Linux require superuser access. This guide assumes the use of sudo(8) for running commands with superuser privileges. Adjust where necessary if you don't use sudo(8).

Installing the ProteanOS Development Kit

First you'll need to get prokit, the ProteanOS Development Kit. This toolkit can install a ProteanOS system, run a ProteanOS shell and other commands, manage software packages on an installed ProteanOS system, and build packages for ProteanOS (with build dependencies automatically installed and removed).

Ensure you have a make(1) utility such as GNU Make installed. No C or C++ compiler or other development tools are necessary to build prokit.

Download a released version of prokit from the files site by HTTP or FTP, e.g.:

$ wget http://files.proteanos.com/pub/prokit/1.0.0/prokit-1.0.0.tar.gz
$ tar -xzf prokit-1.0.0.tar.gz
$ cd prokit-1.0.0/

Or clone it from the Git repository:

$ git clone git://git.proteanos.com/prokit/prokit.git
$ cd prokit/

Configure and build prokit:

$ ./configure
$ make

Or, if you cloned the Git repository, run:

$ ./autogen.sh
$ make

To build from the repository you'll need to have GNU Autoconf and Automake installed.

It is recommended but not necessary that you install prokit to your system:

$ sudo make install

Check that the installation was successful:

$ prokit version

Or, if you didn't install prokit, run:

$ src/prokit version

Refer to the prokit(1) manual page:

$ man prokit

Or, if you didn't install prokit, run:

$ man man/prokit.1

Install a ProteanOS Development System

Now you can install a ProteanOS system into a directory in your file system.

Decide where to install ProteanOS and run:

$ sudo prokit install dev/trunk $root

$root is the directory you chose.

Next install all of the toolchain packages commonly used to build ProteanOS packages:

$ sudo prokit opkg $root install build-essential

This may take a while, depending on your network connection.

Now you're ready to build ProteanOS packages!