[[!meta title="Getting the ProteanOS Development Kit"]]

[[←_Back_to_Installing_ProteanOS|doc/install]]

The [[ProteanOS_Development_Kit|dev/prokit]], or prokit, is a software package
for installing, managing, and developing ProteanOS systems.  prokit enables you
to install a ProteanOS system, run a ProteanOS shell and other commands, manage
software packages on an installed ProteanOS system, and build packages for
ProteanOS.


Dependencies
============

prokit requires the following utilities:

  * gunzip
  * Either sfdisk or fdisk
  * mke2fs
  * cpio
  * xz from XZ Utils
  * mount
  * umount
  * chroot

prokit also requires OpenWrt's usign utility to verify archive signatures.  A
system copy of usign can be used, however few distributions provide one.  An
embedded copy of usign is included, building of which additionally requires:

  * CMake
  * make
  * A C compiler such as GCC and standard C library headers

On a Debian-based distribution such as Trisquel, `sudo apt-get install
build-essential cmake` is sufficient.

To install and manage ProteanOS systems you need a host system running Linux 3.4
or later.

The ProteanOS Development Kit uses the **mount**(8) , **umount**(8), and
**chroot**(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).


Downloading the ProteanOS Development Kit
=========================================

Download a released version of prokit from the files site by [HTTP][prokit-http]
or [FTP][prokit-ftp], e.g.:

    $ gpg --recv-keys 0x225031F047FFE51663ED516F1A459ECDE4D604BE
    $ # Find a signature path from your keyring to 0x1A459ECDE4D604BE
    $ wget http://files.proteanos.com/pub/prokit/2.0.0/prokit-2.0.0.tar.gz \
    > http://files.proteanos.com/pub/prokit/2.0.0/prokit-2.0.0.tar.gz.asc
    $ gpg --verify prokit-2.0.0.tar.gz.asc prokit-2.0.0.tar.gz
    $ tar -xzf prokit-2.0.0.tar.gz
    $ cd prokit-2.0.0/

Or clone prokit from the [Git repository][prokit-git]:

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

[prokit-http]: http://files.proteanos.com/pub/prokit/
[prokit-ftp]: ftp://files.proteanos.com/pub/prokit/
[prokit-git]: http://git.proteanos.com/prokit/prokit.git/


Building the ProteanOS Development Kit
======================================

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.


Installing the ProteanOS Development Kit
========================================

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

    $ sudo make install

Check that the installation was successful:

    $ prokit version


The ProteanOS Development Kit Manual
====================================

prokit comes with a manual, starting with the **prokit**(1) page:

    $ man prokit

Or, if you didn't install prokit, you can find the manual by running:

    $ man man/prokit.1

The manual is also available from the [[prokit_homepage|dev/prokit]].