Skip to content

Arch Linux Repository Configuration

Mattscreative edited this page Dec 5, 2025 · 4 revisions

Arch Linux Repository Configuration Guide

Complete beginner-friendly guide to configuring package repositories on Arch Linux, including mirror selection, repository priorities, and repository management.


Table of Contents

  1. Understanding Repositories
  2. Mirror Configuration
  3. Repository Priorities
  4. Custom Repositories
  5. Troubleshooting

Understanding Repositories

Official Repositories

Main repositories:

  • core: Core packages
  • extra: Extra packages
  • community: Community packages
  • multilib: 32-bit packages

Repository Configuration

Edit pacman.conf:

# Edit config
sudo vim /etc/pacman.conf

Mirror Configuration

Using Reflector

Generate mirrors:

# Install reflector
sudo pacman -S reflector

# Generate top 10 mirrors
sudo reflector --country "United States" --latest 10 --sort rate --save /etc/pacman.d/mirrorlist

# Update
sudo reflector --latest 20 --sort rate --save /etc/pacman.d/mirrorlist

Manual Mirror Selection

Edit mirrorlist:

# Edit mirrorlist
sudo vim /etc/pacman.d/mirrorlist

# Uncomment preferred mirrors
# Order matters - first is tried first

Repository Priorities

Priority Configuration

Set priorities:

# Edit pacman.conf
sudo vim /etc/pacman.conf

Example:

[core]
Include = /etc/pacman.d/mirrorlist

[extra]
Include = /etc/pacman.d/mirrorlist

[community]
Include = /etc/pacman.d/mirrorlist

Custom Repositories

Add Custom Repository

Add repository:

# Edit pacman.conf
sudo vim /etc/pacman.conf

Add:

[custom]
Server = https://example.com/repo/$arch

Update:

# Update database (use -Syu for full update)
sudo pacman -Syu

# Note: -Sy without -u can cause dependency issues
# Only use -Sy when specifically checking package availability

Troubleshooting

Slow Downloads

Change mirror:

# Use reflector
sudo reflector --country "United States" --latest 10 --sort rate --save /etc/pacman.d/mirrorlist

# Update
sudo pacman -Syu

Repository Errors

Fix errors:

# Update package database and upgrade (recommended)
# Note: Always use -Syu together to avoid dependency issues
sudo pacman -Syu

# Clear cache
sudo pacman -Sc

Summary

This guide covered repository configuration, mirrors, priorities, and troubleshooting.


Next Steps


This guide is based on the ArchWiki. For the most up-to-date information, always refer to the official ArchWiki.

Clone this wiki locally