APT HOWTO

Abstract

This document intends to provide the user with a good understanding of the workings of the Debian package management utility, APT. Its goal is to make life easier for new Debian users and to help those who wish to deepen their understanding of the administration of this system. It was created for the Debian project in order to help improve the support available for users of this distribution.

Copyright Notice

Copyright © 2001, 2002 Gustavo Noronha Silva

This manual is licensed under the terms of the GNU FDL (Free Documentation License). It has been written in the hope that it will be useful to the community but it comes with no warranty; use it at your own risk.

Contents

• 1 Introduction
• 2 Basic Configuration
• 2.1 The /etc/apt/sources.list file
• 2.2 How to use APT locally
• 2.3 Deciding which mirror is the best to include in the sources.list file: netselect, netselect-apt
• 2.4 Adding a CD-ROM to the sources.list file
• 3 Managing packages
• 3.1 Updating the list of available packages
• 3.2 Installing packages
• 3.3 Removing packages
• 3.4 Upgrading packages
• 3.5 Upgrading to a new release
• 3.6 Removing unused package files: apt-get clean and autoclean
• 3.7 Using APT with dselect
• 3.8 How to keep a mixed system
• 3.9 How to upgrade packages from specific versions of Debian
• 3.10 How to keep specific versions of packages installed (complex)
• 4 Very useful helpers
• 4.1 How to install locally compiled packages: equivs
• 4.2 Removing unused locale files: localepurge
• 4.3 How to know what packages may be upgraded
• 5 Getting information about packages.
• 5.1 Discovering package names
• 5.2 Using dpkg to find package names
• 5.3 How to install packages "on demand"
• 5.4 How to discover to which package a file belongs
• 5.5 How to keep informed about the changes in the packages.
• 6 Working with source packages
• 6.1 Downloading source packages
• 6.2 Packages needed for compiling a source package
• 7 How to deal with errors
• 7.1 Common errors
• 7.2 Where can I find help?
• 8 What distributions support APT?
• 9 Credits
• 10 New versions of this tutorial

APT HOWTO