Ubuntu

Differences between revisions 56 and 57
Revision 56 as of 2006-06-19 03:10:30
Size: 9959
Editor: dtm9-d9bbb443
Comment: some corrections
Revision 57 as of 2006-06-19 16:06:45
Size: 63
Editor: 127
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
## page was renamed from AddingRepositoriesHowto
||<tablestyle="float:right; font-size: 0.9em; width:40%; background:#F1F1ED; margin: 0 0 1em 1em;" style="padding:0.5em;">'''Contents'''[[BR]][[TableOfContents(3)]]||


[[Anchor(what)]]
== What are Repositories? ==

There are thousands of programs available to install on Ubuntu. These programs are stored in software archives ''(repositories)'' and are available for installation over the Internet. This makes it very easy to install new programs. It is also very secure, because each program you install is thoroughly tested and built specifically for Ubuntu.

The Ubuntu software repository is organised into four "components", on the basis of the level of support Ubuntu can offer them, and whether or not they comply with Ubuntu's [http://www.ubuntu.com/ubuntu/philosophy Free Software Philosophy]. The components are called '''Main''' (officially supported software), '''Restricted''' (supported software that is not available under a completely free license), '''Universe''' (community-maintained, i.e. not officially supported software) and '''Multiverse''' (software that is "not free"). You can find more information about the Ubuntu Repositories [http://www.ubuntu.com/ubuntu/components here].

The Ubuntu Install CDs contain software from the '''Main''' and '''Restricted''' components. Once your system is made aware of the Internet-based locations for these repositories, many more software programs are made available for installation. Using the software package management tools already installed on your system, you can search for, install and update any piece of software directly over the Internet, without the need for the CD.


[[BR]]
== Adding Repositories in Ubuntu ==

attachment:IconsPage/eyes.png This page describes how to manage software repositories in '''Ubuntu 6.06 (Dapper Drake)'''. For '''Kubuntu 6.06''' please see [:KubuntuAddingRepositoriesHowto: Kubuntu repository management]. For '''earlier versions of Ubuntu''' please see [:/Breezy: this wiki page].

attachment:IconsPage/terminal.png The operations described on this page modify the software repositories configuration file located at
 {{{
/etc/apt/sources.list }}}
 Software sources can also be managed by making direct modifications to this file using the command line. If you prefer to use the command line instead of a graphical user interface, see [:../CommandLine: Managing Repositories from the Command Line] instead.


[[BR]]
== Adding the Universe and Multiverse Repositories ==

[[BR]]
 * Navigate to "System" > "Administration" > "Software Properties".

attachment:menu-sw.png

 * A list of repositories or "Channels" will be shown. Scroll down to the three entries that share the '''Community maintained (Universe)''' and '''Non-free (Multiverse)''' attributes:

 attachment:activate-repos.png

 * Activate all three entries by clicking on the checkboxes next to them.

 * Click '''Close''' to save your changes. A dialog box should appear, asking whether you'd like to update the list of repositories. Click '''Reload''' to apply your changes.


[[BR]]
attachment:IconsPage/info.png '''Integration with Synaptic Package Manager'''

 * The next time you use the '''Synaptic''' package manager, click on the '''Reload''' button to make it aware of the new software repositories.

 attachment:reload.png


 * You can also manage software repositories from within '''Synaptic''' by selecting "Settings" > "Repositories".

 attachment:synaptic-repos.png





[[BR]]
[[Anchor(other)]]
== Adding Other Repositories ==

[[BR]]
attachment:IconsPage/warning.png '''Note:''' There are some (but not many) good reasons for which you might want to add non-Ubuntu repositories to your list of software sources. For example, some software cannot be distributed by Ubuntu due to patent and licensing restrictions in some countries (see the RestrictedFormats page for examples). You might want to add repositories that offer such software. Make sure that '''all''' repositories you add in this way have been tested and are known to work on Ubuntu systems. Repositories that are not designed to work with your version of Ubuntu can introduce inconsistencies in your system and might force you to re-install.
----

[[BR]]
[[Anchor(add)]]
You can add custom software repositories by adding the '''apt repository line''' of your software source to the list of repositories. To do so, click on the '''Add''' button next to the Channel list in the Software Preferences panel, then select '''Custom'''.

  attachment:add-custom.png


[[Anchor(aptline)]]
 * Enter the apt line into the dialog box. It should look something like this:

 {{{
deb http://mirror3.ubuntulinux.nl/ dapper-seveas freenx }}}


attachment:IconsPage/info.png For an explanation of the different parts of the apt line, see the [#edit Editing Repositories] section below.



[[BR]]
== Managing Local Repositories ==

=== Disable the CD-ROM Repository ===

If you have installed Ubuntu from one of Ubuntu's CD-ROMs, the CD will be included in the list of repositories used by the package managment tools. When you install a new package, '''Synaptic''' will check whether the package is available locally (i.e. on the CD-ROM). '''Synaptic''' may then ask for the CD-ROM. This can help reduce the size of downloads and speed up the installation process. If you would like '''Synaptic''' to rely solely on the internet repositories for package management, you can disable the CD-ROM entry with a few steps:

 * Launch Synaptic and navigate to "Settings" > "Repositories". [[BR]] A list of software repositories or "Channels" will be shown.

 * Locate the entry for the CD-ROM (it may say something like '''CD disk with Ubuntu 6.06 LTS'''). Click on the checkbox next to it to disable the CD-ROM as a software source.

 * Click the '''Close''' button to save the changes you have made.

 * You can re-enable the CD-ROM at any time using the checkbox next to its entry.



[[BR]]
== Removing Repositories ==

To remove software sources ("Channels") from the list, select the source and click on the '''Remove''' button. (If you only want to disable the repository temporarily, uncheck the checkbox next to the source instead.)

attachment:IconsPage/eyes.png Use with caution: At present, you will not be asked to confirm the remove action. This is not a problem with the Ubuntu repositories as you can simply [#add add them again], but you may have to look up a custom repository line if you mistakenly delete it. (It is always a good idea to back up your sources.list)


[[BR]]
[[Anchor(edit)]]
== Editing Repositories ==

To make changes to a software source, select it in the list and click the '''Edit''' button. A dialog box displays the apt line, broken up into its components.

 attachment:edit-channel.png


 * '''Type''' Software sources may contain software in '''binary''' or '''source code''' format. Select the option that corresponds to the repository.

 attachment:IconsPage/eyes.png The corresponding apt line has '''deb''' for binary repositories and '''deb-src''' for source code repositories.

[[BR]]
 * '''URI''' Enter a valid Uniform Resource Indicator or URI for the software repository. Here's a list of examples:


   * '''cdrom''' [[BR]] {{{
cdrom:[description_of_cd]/ }}}
   * '''ftp''' [[BR]] {{{
ftp://ftp.domain.ext/path/to/repository }}}
   * '''http''' [[BR]] {{{
http://www.domain.ext/path/to/repository }}}
   * '''smb''' (works only when the computer is connected to a Samba share) [[BR]] {{{
file://path/to/repository }}}
  * '''nfs''' (works only if the computer is connected to a NFS share) [[BR]] {{{
file://path/to/local/directory }}}

[[BR]]
 * '''Distribution''' [[BR]] Select the name of the distribution or the name of the distribution version. [[BR]](''dapper-seveas'' [#aptline in the example above].)

[[BR]]
 * '''Components''' [[BR]] Select the repository section to access. Add more sections separated by spaces. [[BR]](The [#aptline example repository] has a ''freenx'' section.)

[[BR]]
 * '''Comment''' [[BR]]Add a comment to describe the repository for easier reference.

[[BR]]
attachment:IconsPage/info.png Repositories defined using the '''Software Preferences''' panel are available to '''Update-Manager''' and will be periodically checked for updates.


[[BR]]
== Managing Authentication Keys ==

'''Authentication keys''' are usually obtained from the maintainer of the software repository. The maintainer will often place a copy of the authentication key on a public key server such as www.keyserver.net. The key can then be retrieved using the command
 {{{
gpg --keyserver [name of keyserver] --recv-keys [keyhash] }}}

 * In our example above, you would import the maintainer's authentication key as follows:

 {{{
gpg --keyserver subkeys.pgp.net --recv-keys 1135D466 }}}

 * Then, add the key to Ubuntu's apt trusted keys database with the following command

 {{{
gpg --export --armor 1135D466 | sudo apt-key add - }}}

 * Note there's a dash at the end of the line

[[BR]]
attachment:IconsPage/info.png For more on apt and authentication keys, see [http://wiki.debian.org/SecureApt SecureApt] on the Debian Wiki.



[[BR]]
== See also ==

 * [:../CommandLine: Managing Software Repositories from the Command Line]

 * [:../Kubuntu: Managing Software Repositories in Kubuntu]

 * Chapter 2 of the Ubuntu Desktop Guide, [http://help.ubuntu.com/ubuntu/desktopguide/C/add-applications.html Adding, Removing and Updating Applications]

 * An [http://www.ubuntulinux.nl/source-o-matic automatic sources.list generator]

 * The [http://www.debian.org/doc/user-manuals#apt-howto Debian Apt User Manual]

 * '''man pages'''

  * sources.list



[[BR]]
----
CategoryDocumentation CategoryCleanup
#REFRESH 0 http://help.ubuntu.com/community/Repositories/Ubuntu

Repositories/Ubuntu (last edited 2008-08-06 16:22:40 by localhost)