Skip to content

Linux Repository Configuration

Mattscreative edited this page Dec 5, 2025 · 3 revisions

Linux Repository Configuration Guide

Complete beginner-friendly guide to configuring package repositories on Linux, covering Arch Linux, CachyOS, and other distributions including mirror selection, repository priorities, performance optimization, and troubleshooting.


Table of Contents

  1. Understanding Repositories
  2. Repository Configuration File
  3. Mirror Configuration
  4. Repository Priorities
  5. CachyOS-Specific Repositories
  6. Optimizing Repository Performance
  7. Custom Repositories
  8. Troubleshooting

Understanding Repositories

What are Repositories?

Repositories are servers that store and serve software packages.

What they do:

  • Store packages: Contain compiled software packages
  • Serve packages: Provide packages for download
  • Maintain metadata: Keep package information up to date
  • Provide security: Packages are signed and verified

Why repositories matter:

  • Package availability: Determines what software you can install
  • Update speed: Faster mirrors = faster updates
  • Reliability: Good mirrors = reliable package downloads
  • Performance: Closer mirrors = faster downloads

Official Repositories

Main repositories (Arch/CachyOS):

  • core: Essential system packages
  • extra: Additional software packages
  • community: Community-maintained packages
  • multilib: 32-bit packages (for 64-bit systems)

Repository Configuration File

Configuration File Location

Main configuration file:

/etc/pacman.conf

What this file does:

  • Defines which repositories to use
  • Sets repository priorities
  • Configures package signing
  • Sets download options

Viewing Configuration

View current configuration:

cat /etc/pacman.conf

Edit configuration:

sudo vim /etc/pacman.conf

Mirror Configuration

Using Reflector

Install reflector:

# Arch/CachyOS
sudo pacman -S reflector

Generate mirrors:

# 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

CachyOS-Specific Repositories

CachyOS Repositories

CachyOS-specific repositories:

  • cachyos: CachyOS optimized packages
  • cachyos-v3: x86-64-v3 optimized packages
  • cachyos-v4: x86-64-v4 optimized packages
  • cachyos-zen4: Zen4 optimized packages

What each repository contains:

  • cachyos: Optimized versions of packages
  • cachyos-v3: x86-64-v3 instruction set optimized
  • cachyos-v4: x86-64-v4 instruction set optimized
  • cachyos-zen4: Zen4 architecture optimized

Configuration:

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

Add CachyOS repositories:

[cachyos]
Server = https://mirror.cachyos.org/repo/x86_64/$repo

[cachyos-v3]
Server = https://mirror.cachyos.org/repo/x86_64-v3/$repo

Optimizing Repository Performance

Mirror Ranking

Rank mirrors by speed:

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

Parallel Downloads

Enable parallel downloads:

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

Add:

[options]
ParallelDownloads = 5

Custom Repositories

Add Custom Repository

Add repository:

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

Add:

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

Troubleshooting

Repository Errors

Check repository:

# Check repository (use -Syu for full update)
# Note: -Sy without -u can cause dependency issues
# Only use for quick repository connectivity check
sudo pacman -Syu

# Check mirrors
curl -I https://mirror.example.com/repo

Slow Downloads

Change mirrors:

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

Summary

This guide covered repository configuration for Arch Linux, CachyOS, and other distributions, including mirror selection, repository priorities, CachyOS-specific repositories, and optimization.


Next Steps


This guide covers Arch Linux, CachyOS, and other Linux distributions. CachyOS-specific repositories are highlighted where applicable.

Clone this wiki locally