Arch Linux yay¶

ID: yay
Home page: https://github.com/Jguer/yay
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: meta_package_manager/managers/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 pacaur, pacman, paru 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`	✓
`orphans`	✓
`search`	✓	extended search backfilled by `mpm`
`install`	✓
`upgrade`	✓
`upgrade_all`	✓
`remove`	✓	`--orphans` also drops the package’s orphaned dependencies
`sync`	✓
`cleanup`	✓	`--orphans` sweep backfilled by `mpm`
`doctor`	✓

Selecting and configuring `yay`¶

Deselect yay for a single run with --no-yay, or persist the choice in your configuration:

[mpm]
yay = false

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.

Keep it enabled but tune how mpm drives it with a per-manager override:

[mpm.managers.yay]
timeout = 900

mpm config-template yay prints every overridable attribute as a ready-to-paste block.

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.

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 gates on. Git commit dates are client-set (GIT_COMMITTER_DATE), forgeable, and never consulted

Version probe¶

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+)"

Changelog¶

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.