Skip to content

Arch Linux Custom Repositories

Mattscreative edited this page Dec 5, 2025 · 3 revisions

Arch Linux Custom Repositories Guide

Complete beginner-friendly guide to custom repositories on Arch Linux, including creating repositories, adding packages, and repository management.


Table of Contents

  1. Creating Repository
  2. Adding Packages
  3. Repository Management
  4. Troubleshooting

Creating Repository

Setup Repository

Create repository:

# Create directory
mkdir -p ~/repo

# Initialize repository
repo-add ~/repo/custom.db.tar.gz

# Or use repo-add with package
repo-add ~/repo/custom.db.tar.gz package.pkg.tar.zst

Adding Packages

Add Package

Add to repository:

# Add package
repo-add ~/repo/custom.db.tar.gz package.pkg.tar.zst

# Add multiple
repo-add ~/repo/custom.db.tar.zst *.pkg.tar.zst

Update Repository

Update:

# Update database
repo-add ~/repo/custom.db.tar.zst package.pkg.tar.zst

# Or rebuild
repo-add -n ~/repo/custom.db.tar.zst ~/repo/*.pkg.tar.zst

Repository Management

Add to pacman.conf

Configure pacman:

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

Add:

[custom]
SigLevel = Optional TrustAll
Server = file:///home/user/repo

Sync Repository

Sync:

# Update database and upgrade (recommended)
# Note: Use -Syu to avoid dependency issues
sudo pacman -Syu

# Install from custom repo
sudo pacman -S package-name

Troubleshooting

Repository Errors

Check repository:

# Check database
tar -tzf ~/repo/custom.db.tar.gz

# Rebuild repository
repo-add -n ~/repo/custom.db.tar.zst ~/repo/*.pkg.tar.zst

Summary

This guide covered creating repositories, adding packages, and repository management.


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