[[PageOutline(2-4)]]
== APT Repositories ==

Releases of {{{freeDiameter}}} are compiled for your convenience as {{{.deb}}} packages for Debian and Ubuntu distributions, and distributed on this website. In order to use these packages, follow the instructions on this page.

=== Repository's GPG key ===

Modern distributions use secure APT signed repositories for packages distribution.
This is how you can import the public key of the freeDiameter repository.

{{{
$ # First, retrieve the key from the website
$ wget http://www.freediameter.net/packages/repository.key

$ # Optionally, check the key was not tempered with
$ md5sum repository.key
3483b09a2b6a1e882ac55d5d33354358  repository.key
$ # (correct value is in repository.md5sum file)

$ # Finally import this key into APT
$ sudo apt-key add repository.key 
OK
}}}

=== Package repository address ===

Next step is to add the declaration of the repository to your apt configuration.

If your system has a ''/etc/apt/sources.list.d'' folder, it is advised to create a new file inside this folder, for example called {{{freediameter.list}}}. Otherwise, simply add the following content to you ''/etc/apt/sources.list'' file.

==== Debian ====

 * Debian Lenny (stable):
{{{
## freeDiameter APT repository
deb http://www.freediameter.net/packages/debian lenny contrib

## In order to rebuild the freeDiameter packages, 
## you will need backports for lenny also.
deb-src http://www.freediameter.net/packages/debian lenny contrib
}}}

 * Debian Squeeze (testing):
{{{
## freeDiameter APT repository
deb http://www.freediameter.net/packages/debian squeeze contrib
deb-src http://www.freediameter.net/packages/debian squeeze contrib
}}}


 * Debian Sid (unstable):
{{{
## freeDiameter APT repository
deb http://www.freediameter.net/packages/debian sid contrib
deb-src http://www.freediameter.net/packages/debian sid contrib
}}}

==== Ubuntu ====
 * Ubuntu Karmic (9.10):
{{{
## freeDiameter APT repository
deb http://www.freediameter.net/packages/ubuntu karmic universe
deb-src http://www.freediameter.net/packages/ubuntu karmic universe
}}}

 * Ubuntu Lucid (10.04):
{{{
## freeDiameter APT repository
deb http://www.freediameter.net/packages/ubuntu lucid universe
deb-src http://www.freediameter.net/packages/ubuntu lucid universe
}}}

=== Using the repository ===

Once you have configured apt properly, the following commands should work.
{{{
$ sudo aptitude update
$ aptitude search freediameter
p   freediameter-accounting-server    - freeDiameter simple Accounting server.
p   freediameter-common               - The libfreeDiameter library.
p   freediameter-daemon               - The freeDiameter daemon.
[...]
}}}

You can for example install a Diameter EAP server with:
{{{
$ sudo aptitude install freediameter-eap-server
}}}

----
=== Administration stuff ===
The scripts and configuration files used to generate this repository can be found at: [http://www.freediameter.net/packages/scripts]. Please feel free to propose improvements.