====== Installing Binary Packages ======


===== pkgin =====

[[http://pkgin.net/|pkgin]] is the binary package manager for MINIX 3. This page describes how to use it.

<!> pkgin first appeared in Minix 3.1.8. If you're using an older version of Minix, you'll need to use the ''packman'' package manager instead.

Software packages also can built from their source code. See [[.:installingsourcepackages|Installing Source Packages]] for details.

===== Using pkgin =====

**First**, you will need to fetch the package list and populate the package database:

<code>
# pkgin update
</code>

This step can be re-run to update the package list.

If you would like to install a package, you can run:

<code>
# pkgin install scmgit-base
# pkgin install subversion-base
# pkgin install gcc44
</code>

More than one at a time:

<code>
# pkgin in zip rsync
</code>

Also, there is a way to install everything:

<code>
# pkgin in $( pkgin av | awk '{ print $1 }' )
</code>

{i} Be sure to have enough [[.:workingwithstorage|free space]] if you install all the packages. //Pkgin// will estimate the space needed when it asks for your confirmation.

If you would like to search for a specific package, you can run:

<code>
# pkgin search subversion
</code>

To see a list of all available packages, you can run:

<code>
# pkgin available
</code>

You can also use //more// to pause between pages:

<code>
# pkgin available | more
</code>

If you would like to see all the available //pkgin// actions, you can run:

<code>
# pkgin
</code>

Additionally, you can study the man. page:

<code>
# man 1 pkgin
</code>

===== Installing from the CD =====

Many packages are available directly from the CD. This can be helpful in some circumstances, and is generally faster than downloading from the online repository.

To install packages from the CD, you can use //pkgin_cd//. This command uses the CD-ROM as the package repository. It is a wrapper for //pkgin// and therefore supports the same commands.

To begin using //pkgin_cd//:

  - Start your installed system
  - Insert the CD
  - Type //pkgin_cd//

Like //pkgin//, it can install all packages:

<code>
# pkgin_cd in $( pkgin_cd av | awk '{ print $1 }' )
</code>

To remove the CD safely and use the online package repository:

  - Type //umount /mnt// to stop using the CD
  - Remove the CD
  - Type //pkgin update//

===== Testing repository =====

This repository contains more and newer packages than the regular one, but those packages still need testing and validation. If you are up to it we would be very happy to get feedback on those packages!

To use it you will have to do the following:

  * Edit **/usr/pkg/etc/pkgin/repositories.conf** so it contains :
<code>
  ftp://ftp.minix3.org/pub/minix/packages/$osrelease-testing/$arch/All
  #ftp://ftp.minix3.org/pub/minix/packages/$osrelease/$arch/All
</code>
  * Clean the local cache:
<code>
  # pkgin clean
</code>
  * Update the db so that pkgin sees all the packages.
<code>
  # pkgin update
</code>

That's all! Now you can try out the new packages. We are awaiting for your feedback, 
even if it 'just works'. We need to update our available list of application. You can send us a mail
directly, our post to the MINIX google group.

Note this will not update previously installed package, to replace them with the newer version you have to do this:
<code>
  # pkgin full-upgrade
</code>

When you have tested a package, please inform the community about that package status by editing [[:DevelopersGuide:PkgsrcStatus]], or sending an email to the minix team.

===== Notes =====

//Pkgin// will install the software in ///usr/pkg/bin//, which is already in your PATH by default.