Arch Linux yay¶

ID: yay
Links: Documentation · Repository
Upstream stars: ⭐ 13,762
Last commit: 2026-09-26
Version requirement: >= 11
Cooldown: ✓
Platforms: 🅱️ BSD · 🐧 Linux · ⨂ Unix
Operations: installed · outdated · orphans · search · install · upgrade · upgrade_all · remove · sync · cleanup · doctor
purl types: pkg:alpm/ · pkg:yay/
CLI name: yay
Every call: yay --noconfirm --color never <command>
Issues and PRs: 📦 manager: pacman-based
Source: pacman.py

AUR helper wrapping pacman, driven through the yay binary.

Inherits every operation, parser and forced argument from Pacman; the binary, version probe and the release-age cooldown below are what differ. Its own --query --upgrades reports AUR updates on top of the official repositories.

Unlike pacman, the helper must run as the regular user: yay warns under root (Avoid running yay as root/sudo.) and any AUR build then dies in makepkg, which refuses to run as root. yay drives sudo itself for the privileged steps (its --sudo, --sudoflags and --sudoloop options), so mpm never wraps it in sudo. That also keeps the injected XDG_CONFIG_HOME cooldown overlay below visible to yay, where a sudo wrap would have reset the environment.

Note

yay exposes no release-age flag, so mpm enforces the supply-chain cooldown by overlaying a generated init.lua through a private XDG_CONFIG_HOME (see Yay.cooldown_env()). This needs yay >= 13.0.0, when the Lua UpgradeSelect/AURPreInstall hooks landed; an older yay stays a usable manager but cannot honor a cooldown. The upstream request for a less invasive injection point is Jguer/yay#2883.

What `mpm` adds to `yay`¶

Through mpm, yay gains:

a one-command cleanup --orphans that removes every orphaned dependency at once
--extended search, to match against package descriptions

Bigger still, mpm reaches across every manager at once: mpm installed and mpm outdated cover yay alongside aura, dkp-pacman, pacaur, pacman, pamac, paru, pikaur, shelly, trizen and any other manager you run in one table, mpm upgrade --all updates them together, and mpm sbom exports the whole machine as one bill of materials.

Every mpm command also gains --dry-run and --plan previews, cross-scheme version comparison and purl identifiers. See manager augmentations for how each one is built.

Your `yay` commands, in `mpm`¶

You already know yay: each operation maps one-to-one onto mpm, in an interface shared by every manager.

To…	With `yay`	With `mpm`
List what’s installed	`pacman --query`	`mpm --yay installed`
List outdated packages	`pacman --query --upgrades`	`mpm --yay outdated`
Search for a package	`pacman --sync --search fire`	`mpm --yay search fire`
Install a package	`sudo pacman --sync firefox`	`mpm install pkg:yay/firefox`
Upgrade one package	`sudo pacman --sync firefox`	`mpm --yay upgrade firefox`
Upgrade everything	`sudo pacman --sync --refresh --sysupgrade`	`mpm --yay upgrade --all`
Remove a package	`sudo pacman --remove firefox`	`mpm remove pkg:yay/firefox`
List orphaned dependencies	`pacman --query --deps --unrequired`	`mpm --yay orphans`
Clear caches	`sudo pacman --sync --clean --clean`	`mpm --yay cleanup --cache`
Run health checks	`pacman --database --check`	`mpm --yay doctor`

Prefix any command above with --dry-run to simulate the underlying manager calls without touching the system: the safe way to watch what mpm would do before trusting it.

Operations¶

Operation	Supported	Notes
`installed`	✅
`outdated`	✅	Only packages tracked in a sync database are reported; foreign packages (AUR builds, `-U` installs) stay invisible to the plain `pacman` binary.
`orphans`	✅
`search`	✅	Extended search backfilled by `mpm`.
`install`	✅	A package already installed as a dependency is marked explicit by `mpm`.
`upgrade`	✅
`upgrade_all`	✅
`remove`	✅	The `--orphans` flag also drops the package’s orphaned dependencies.
`sync`	✅
`cleanup`	✅	The `--orphans` sweep is backfilled by `mpm`.
`doctor`	✅

Configuration¶

Ignore yay on the mpm CLI by passing the --no-yay option.
Ignore it for every run in your configuration:
```
[mpm]
yay = false
```
Raise the timeout of all yay calls:
```
[mpm.overrides.yay]
timeout = 900
```

Run mpm config-template yay to print all overridable settings for your configuration file:

[mpm.overrides.yay]
cli_names = [
    "yay",
]
cli_search_path = []
dry_run = false
ignore_auto_updates = true
plan = false
post_args = []
pre_args = [
    "--noconfirm",
    "--color",
    "never",
]
pre_cmds = []
requirement = ">=11.0.0"
stop_on_error = false
unmaintained = false
version_cli_options = [
    "--version",
]
version_regexes = [
    "yay\\s+v(?P<version>\\S+)",
]

The arguments and environment variables listed in the box atop this page are forced on every yay call, so runs stay quiet, non-interactive and reproducible: the defaults you would set in CI anyway.

Recipes¶

A few jobs you would otherwise script around yay, one mpm command each:

Snapshot and clone a machine: mpm --yay dump yay.toml, then mpm restore yay.toml on the next one.
Export a compliance SBOM: mpm --yay sbom (CycloneDX by default, --spdx for SPDX).
Gate CI on health: mpm --yay doctor relays Arch Linux yay’s own diagnosis and exits non-zero on trouble.

Privilege escalation¶

Arch Linux yay runs sudo from inside its own commands: mpm never wraps it, keeps an already-warm credential cache alive for those internal escalations, and warns when a mutating call goes silent on a terminal with a cold cache, since a password prompt may be hiding in the stream.

See privilege escalation for the full policy.

Concurrency¶

mpm never runs yay at the same time as aura, pacaur, pacman, pamac, paru, pikaur or trizen: they all reach the pacman database (/var/lib/pacman/db.lck), and two of them mutating at once fail to init their transaction. Each mutating operation waits for the previous one, even with a higher --jobs, while managers outside this group keep running in parallel.

Only mutations are held back. The read-only queries (installed, outdated, search) take no backend lock and stay fully concurrent.

Cooldown¶

mpm natively enforces its release-age cooldown on Arch Linux yay, injecting the XDG_CONFIG_HOME environment variable on every call. Point it at a window (mpm --cooldown 7 --yay upgrade --all) to skip anything published in the last 7 days: a guard against a compromised or yanked fresh release landing before anyone notices.

Status: ✅ Enforced (yay ≥ 13.0)
Mechanism: generated init.lua overlay via XDG_CONFIG_HOME (UpgradeSelect + AURPreInstall hooks)
Reference: Jguer/yay#2883

A cooldown only pays off where a compromised release can be withdrawn while the clock runs, and can only be emulated where the registry dates its releases. From the retraction table:

Registry: AUR
Retraction: None at the version level: an AUR package is a git repository with no per-version artifact to withdraw, so remediation is a maintainer push or deletion of the whole package
Publish date: ✅ server-set LastModified, the push timestamp mpm’s yay overlay and paru probe gate on. Git commit dates are client-set (GIT_COMMITTER_DATE), forgeable, and never consulted

Version check¶

The version is probed by running:

$ yay --version
yay v11.1.2 - libalpm v13.0.1

and extracted with:

r"yay\s+v(?P<version>\S+)"

Upstream project¶

Metrics	`Jguer/yay`
Activity
Popularity
Metadata

Changelog¶

8.0.0 (2026-09-20)
- Mark a package already installed as a dependency as explicitly installed when mpm install or mpm restore names it, so mpm cleanup --orphans keeps it.
- Stop running the AUR helpers concurrently with pacman and with each other, all of them driving the same pacman database.
7.4.0 (2026-07-25)
- The AUR helpers are no longer wrapped in sudo: they refuse or break under root (makepkg rejects root builds, paru aborts AUR transactions, pacaur aborts its sync operations) and escalate through their own internal sudo pacman calls, which mpm now tracks with the internal_sudo marker (warm credential-cache keepalive, hidden-prompt watchdog). This also lets yay’s cooldown environment overlay reach the process, where the sudo wrap used to strip it.
7.1.0 (2026-07-07)
- Honor --cooldown by overlaying a generated init.lua through a private XDG_CONFIG_HOME, holding back AUR upgrades and installs newer than the release-age floor while preserving the user’s own yay config. Requires yay 13.0.0 for its Lua hooks.
6.2.0 (2026-03-25)
- Add --color never option to all invocations.
5.3.0 (2022-06-25)
- Run install, upgrade, remove and cleanup operations with sudo.
5.2.0 (2022-06-16)
- Add yay support. Refs #527.