Previous | Contents | Next

Apt-Cacher-NG User Manual

Apt-Cacher NG is a caching proxy for software packages which are downloaded by Unix/Linux system distribution mechanisms from mirror servers accessible via HTTP.

This manual provides an overview of Apt-Cacher-NG's features and a walk through the required configuration steps for server administrators and users of the proxy.

• Chapter 1: Introduction
• Chapter 2: Running apt-cacher-ng
• Chapter 3: Basic Configuration
  • 3.1 Server Configuration
  • 3.2 Client Configuration
• Chapter 4: Advanced Server Configuration
  • 4.1 Vocabulary
  • 4.2 Configuration file types
  • 4.3 Repositories and URL mapping
• Chapter 5: Security
  • 5.1 Access control by IP interface
  • 5.2 Access control with libwrap
  • 5.3 Access control with inetd
  • 5.4 Access control with iptables
  • 5.5 Target port filter
• Chapter 6: Distribution specific instructions
  • 6.1 Debian and Ubuntu
  • 6.2 OpenSUSE
  • 6.3 Fedora Core
  • 6.4 Arch Linux
  • 6.5 Sourceforge mirror network
  • 6.6 Cygwin mirrors
  • 6.7 Limited expiration
• Chapter 7: Maintenance
  • 7.1 Cache cleanup
  • 7.2 Removal of distribution releases
• Chapter 8: HOWTOs and FAQ
  • 8.1 Package import
  • 8.2 Cache overview
  • 8.3 JIGDO usage
  • 8.4 Avoid use of apt-cacher-ng for certain hosts
  • 8.5 Avoid caching for certain domains or certain file types
  • 8.6 How to make big download series faster
  • 8.7 How to import DVDs or ISO images
  • 8.8 How to integrate DVDs or ISO image data
  • 8.9 How to execute commands before and after going online?
  • 8.10 Listen to only specific interfaces or IP protocols
  • 8.11 How to avoid use of IPv4 (or IPv6) where possible?
  • 8.12 Use the proxy without storing all data twice
  • 8.13 Partial Mirroring
• Chapter 9: Troubleshooting
  • 9.1 Debugging
  • 9.2 Problem: keeps delivering damaged files
  • 9.3 Problem: regular expiration action reproducibly aborts
  • 9.4 Problem: download fails with 503 ... status message
  • 9.5 Problem: apt-get freezes when downloading files
  • 9.6 apt-get reports corrupted bzip2 data
  • 9.7 Problem: apt-cacher-ng refuses to start with "Address already in use"
• Chapter 10: Known Bugs and Limitations
• Chapter 11: Contact