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

• Arch Linux Package Management - Package management
• Arch Linux Arch Build System - Building packages
• ArchWiki Custom Repositories: https://wiki.archlinux.org/title/Pacman/Tips_and_tricks#Custom_local_repository

---

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