= Adding Ubuntu GIS repository to your system's software sources =

To use Ubuntu GIS packages, you need to add the repository to your system's software sources.

Verify that your ubuntu distribution is supported by the Ubuntu GIS project: [wiki:SupportedDistributions List of the supported distributions]

== Add the sources.list entries ==

Ubuntu GIS has two different PPA:
 * Stable: updated every six months, contains a stable state of the unstable ppa ( https://launchpad.net/~ubuntugis/+archive/ppa )
 * Unstable: updated frequently, contains the up-to-date packages. This ppa may broke something. ( https://launchpad.net/~ubuntugis/+archive/ubuntugis-unstable )

See the "Technical details about this PPA" section of one of the pages above to know the entries to add.

1. Open the file ''/etc/apt/sources.list'' with a text editor and append the entries to the file.

2. Authenticate the repository. Open your terminal and enter:
{{{
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 314DF160 
}}}

''314DF160 is the OpenPGP key of the Ubuntu GIS repository''

If you prefer adding the entries using the GUI, see this page: https://launchpad.net/+help/soyuz/ppa-sources-list.html

3. Update your system's package list:
{{{
sudo apt-get update
}}}