Diff for "Packaging/PPA/InstallingSoftware"

Not logged in - Log In / Register

Differences between revisions 1 and 10 (spanning 9 versions)
Revision 1 as of 2009-07-29 15:31:52
Size: 2868
Comment:
Revision 10 as of 2010-02-09 17:55:05
Size: 5156
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
'''DRAFT: this page is a work in progress. Please [[Feedback|seek further help]] or check the [[TitleIndex|wiki index]] for a complete page on this topic.''' ## page was renamed from Packaging/InstallingFromAPPA/Draft
~- [[FrontPage|Launchpad Help]] > [[Packaging]] > [[Packing/PPA|PPAs]] > Installing software from a PPA -~
Line 4: Line 5:

= Overview =
Line 9: Line 12:
== Adding a PPA to your Ubuntu repositories == = Adding a PPA to your Ubuntu system =
Line 11: Line 14:
Adding a PPA to Ubuntu takes no more than a couple of minutes. == In Ubuntu 9.10 (Karmic) and subsequent versions ==
Line 13: Line 16:
'''Step 1:''' Copy the first line from the ''apt sources.list entries'' section of the PPA overview page. For example: If you're using the most recent version of Ubuntu, or any that has been released since Ubuntu 9.10, adding a PPA is really simple.

'''Step 1:''' Visit the PPA's overview page in Launchpad and look for the heading that reads ''Adding this PPA to your system''. Make a note of the PPA's location, which looks like:
Line 16: Line 21:
deb http://ppa.launchpad.net/awn-testing/ubuntu jaunty main ppa:gwibber-daily/ppa
Line 19: Line 24:
Step 2: On your Ubuntu computer, open ''System > Administration > Software Sources''.

{{attachment:software-sources.png}}

Step 3: Click the ''Third Party Software'' tab.

Step 4: Click the ''Add'' button.

Step 5: Paste the line you copied in step 1 and click the Add Source button.

{{attachment:add-apt-line.png}}

Step 6: Now copy the second line from the apt sources.list entries section of the PPA overview page and paste it in just as you did in steps 4 and 5.

When prompted, reload the software sources information. Don't worry if you see a warning about unverified software sources; we're going to fix that next.

== Adding the PPA's key to Ubuntu ==

Now Ubuntu knows about the PPA. It also needs to know how to check the software hasn't changed since Launchpad built it.

'''Note:''' This is not an endorsement of any of the software in PPAs. You must make sure you trust the PPA owner before installing their software.

'''Step 1:''' On the PPA's overview page you'll see the PPA's OpenPGP key id. It'll look something like this: ''1024/12345678''. Copy it, or make a note of, the portion after the slash, e.g: 12345678.

Step 2: Open your terminal and enter:
'''Step 2:''' Open a terminal and enter:
Line 46: Line 27:
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 12345678 sudo add-apt-repository ppa:user/ppa-name
Line 49: Line 30:
Replace ''12345678'' with the key id you copied in step 1. ||<tablestyle="font-size: 0.8em; width:30%; background:#F1F1ED; margin: 1em 1em 0 0;" style="padding:0.5em;">{{attachment:add-apt-repo1.png}}||
||<style="text-align: center;">'''Adding the repository'''||
Line 51: Line 33:
Step 3: Finally, tell Ubuntu to re-load the details of each software archive it knows about: Replace ```ppa:user/ppa-name``` with the PPA's location that you noted above.

Your system will now fetch the PPA's key. This enables your Ubuntu system to verify that the packages in the PPA have not been interfered with since they were built.

||<tablestyle="font-size: 0.8em; width:30%; background:#F1F1ED; margin: 1em 1em 0 0;" style="padding:0.5em;">{{attachment:add-apt-repo2.png}}||
||<style="text-align: center;">'''Ubuntu adding the repository and its key'''||

'''Important:''' This is not an endorsement of any of the software in PPAs. You must make sure you trust the PPA owner before installing their software.

'''Step 3:''' Now, as a one-off, you should tell your system to pull down the latest list of software from each archive it knows about, including the PPA you just added:
Line 57: Line 48:
You're now ready to install software from the PPA, using a tool such as ''apt-get'' in the Terminal or ''Synaptic''. Now you're ready to start installing software from the PPA! If you already have the software installed and you're adding the PPA to get a more recent/different version, you may just need to run:

{{{
sudo apt-get dist-upgrade
}}}

== On older (pre 9.10) Ubuntu systems ==

'''Step 1:''' Visit the PPA's overview page in Launchpad. Look for the heading that reads ''Adding this PPA to your system'' and click the ``Technical details about this PPA`` link.

'''Step 2:''' Use the ``Display sources.list entries`` drop-down box to select the version of Ubuntu you're using.

'''Step 3:''' You'll see that the text-box directly below reads something like this:

{{{
deb http://ppa.launchpad.net/gwibber-daily/ppa/ubuntu jaunty main
deb-src http://ppa.launchpad.net/gwibber-daily/ppa/ubuntu jaunty main
}}}

||<tablestyle="font-size: 0.8em; width:30%; background:#F1F1ED; margin: 1em 1em 0 0;" style="padding:0.5em;">{{attachment:add-ppa.png}}||
||<style="text-align: center;">'''PPA details'''||

Copy those lines.

'''Step 4:''' Open a terminal and type:

{{{
sudo gedit /etc/apt/sources.list
}}}

This will open a text editor containing the list of archives that your system is currently using. Scroll to the bottom of the file and paste the lines you copied in the step above.

Save the file and exit the text editor.

'''Step 5:''' Back on the PPA's overview page, look for the ''Signing key'' heading. You'll see something like:

{{{
1024R/72D340A3 (What is this?)
}}}

Copy the portion after the slash but not including the help link; e.g. just ``72D340A3``.

'''Step 6:''' Now you need to add that key to your system so Ubuntu can verify the packages from the PPA. In your terminal, enter:

{{{
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 72D340A3
}}}

Replace ``72D340A3`` with whatever you copied in the step 5.

This will now pull down the PPA's key and add it to your system.

'''Important:''' This is not an endorsement of any of the software in PPAs. You must make sure you trust the PPA owner before installing their software.

'''Step 7:''' Now, as a one-off, you should tell your system to pull down the latest list of software from each archive it knows about, including the PPA you just added:

{{{
sudo apt-get update
}}}

Now you're ready to start installing software from the PPA! If you already have the software installed and you're adding the PPA to get a more recent/different version, you may just need to run:

{{{
sudo apt-get dist-upgrade
}}}
Line 61: Line 116:
To publish software in your own PPA, you need to [[PPA/BuildingASourcePackage|build a source package]]. To publish software in your own PPA, you need to [[Packaging/PPA/BuildingASourcePackage|build a source package]].
Line 63: Line 118:
||<tablestyle="border: 0; width: 100%;"> ~-[[Packaing/PPA|< PPA overview]] -~ ||<style="text-align: right;"> ~-[[Packaging/BuildingASourcePackage|Building a source package >]] -~|| ||<tablestyle="border: 0; width: 100%;"> ~-[[Packaging/PPA|< PPA overview]] -~ ||<style="text-align: right;"> ~-[[Packaging/PPA/BuildingASourcePackage|Building a source package >]] -~||

Launchpad Help > Packaging > PPAs > Installing software from a PPA

Overview

PPAs work like normal Ubuntu archives. You can install software in the usual way -- for example, through apt-get or synaptic -- and whenever there's an update Ubuntu will prompt you to install it.

To start installing software from a PPA, you need to tell Ubuntu where to find it and how to verify the integrity of the packages.

Adding a PPA to your Ubuntu system

In Ubuntu 9.10 (Karmic) and subsequent versions

If you're using the most recent version of Ubuntu, or any that has been released since Ubuntu 9.10, adding a PPA is really simple.

Step 1: Visit the PPA's overview page in Launchpad and look for the heading that reads Adding this PPA to your system. Make a note of the PPA's location, which looks like:

ppa:gwibber-daily/ppa

Step 2: Open a terminal and enter:

sudo add-apt-repository ppa:user/ppa-name

add-apt-repo1.png

Adding the repository

Replace ppa:user/ppa-name with the PPA's location that you noted above.

Your system will now fetch the PPA's key. This enables your Ubuntu system to verify that the packages in the PPA have not been interfered with since they were built.

add-apt-repo2.png

Ubuntu adding the repository and its key

Important: This is not an endorsement of any of the software in PPAs. You must make sure you trust the PPA owner before installing their software.

Step 3: Now, as a one-off, you should tell your system to pull down the latest list of software from each archive it knows about, including the PPA you just added:

sudo apt-get update

Now you're ready to start installing software from the PPA! If you already have the software installed and you're adding the PPA to get a more recent/different version, you may just need to run:

sudo apt-get dist-upgrade

On older (pre 9.10) Ubuntu systems

Step 1: Visit the PPA's overview page in Launchpad. Look for the heading that reads Adding this PPA to your system and click the Technical details about this PPA link.

Step 2: Use the Display sources.list entries drop-down box to select the version of Ubuntu you're using.

Step 3: You'll see that the text-box directly below reads something like this:

deb http://ppa.launchpad.net/gwibber-daily/ppa/ubuntu jaunty main
deb-src http://ppa.launchpad.net/gwibber-daily/ppa/ubuntu jaunty main

add-ppa.png

PPA details

Copy those lines.

Step 4: Open a terminal and type:

sudo gedit /etc/apt/sources.list

This will open a text editor containing the list of archives that your system is currently using. Scroll to the bottom of the file and paste the lines you copied in the step above.

Save the file and exit the text editor.

Step 5: Back on the PPA's overview page, look for the Signing key heading. You'll see something like:

1024R/72D340A3 (What is this?)

Copy the portion after the slash but not including the help link; e.g. just 72D340A3.

Step 6: Now you need to add that key to your system so Ubuntu can verify the packages from the PPA. In your terminal, enter:

sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 72D340A3

Replace 72D340A3 with whatever you copied in the step 5.

This will now pull down the PPA's key and add it to your system.

Important: This is not an endorsement of any of the software in PPAs. You must make sure you trust the PPA owner before installing their software.

Step 7: Now, as a one-off, you should tell your system to pull down the latest list of software from each archive it knows about, including the PPA you just added:

sudo apt-get update

Now you're ready to start installing software from the PPA! If you already have the software installed and you're adding the PPA to get a more recent/different version, you may just need to run:

sudo apt-get dist-upgrade

Next steps

To publish software in your own PPA, you need to build a source package.

< PPA overview

Building a source package >

Packaging/PPA/InstallingSoftware (last edited 2010-02-09 17:55:05 by matthew.revell)