hailey.at / myaur
An AUR (Arch User Repository) mirror service written in Go
fork atom
myaur / README.md
at main 2.2 kB view raw view code

myaur#

A simple, self-hosted AUR (Arch User Repository) mirror written in Go. Provides both RPC API endpoints and git protocol access to AUR packages.

myaur takes advantage of the official AUR mirror on GitHub. You may use any mirror that you wish, however, note that it must have the same format as the official repo, in that each individual package should be a branch within the repo.

Installation#

Using Docker Compose#

The easiest way to start the mirror is to use docker compose up -d. This will start both the myaur service and set up a Caddy reverse proxy.

docker compose up -d

If you wish to use your own domain, modify the Caddyfile and change :443 to your domain.

Building from Source#

Requirements:

  • Go 1.25.3 or later
  • Git
go build -o myaur ./cmd/myaur

Usage#

Populate Database#

If you wish to clone the mirror repo and populate the database, you can do so without actually serving the mirror API.

./myaur populate \
  --database-path ./myaur.db \
  --repo-path ./aur-mirror \
  --concurrency 10

Options:

  • --database-path: Path to SQLite database file (default: ./myaur.db)
  • --repo-path: Path to clone/update AUR git mirror (default: ./aur-mirror)
  • --remote-repo-url: Remote AUR repository URL (default: https://github.com/archlinux/aur.git)
  • --concurrency: Number of worker threads for parsing (default: 10)
  • --debug: Enable debug logging

Serve#

To serve the API:

./myaur serve \
  --listen-addr :8080 \
  --database-path ./myaur.db \
  --repo-path ./aur-mirror \
  --concurrency 10

Options:

  • --listen-addr: HTTP server listen address (default: :8080)
  • --database-path: Path to SQLite database file (default: ./myaur.db)
  • --repo-path: Path to AUR git mirror (default: ./aur-mirror)
  • --remote-repo-url: Remote AUR repository URL (default: https://github.com/archlinux/aur.git)
  • --concurrency: Number of worker threads for parsing (default: 10)
  • --auto-update: Whether or not to automtically fetch updates from the remote repo (default: true)
  • --update-interval: Time between automatic fetches (default: 1h)
  • --debug: Enable debug logging