KAS-PURGE(1)

💅 KAS-PURGE — the kas purge command, explained by your bestie

okay so you found kas-purge in the kas manual suite and you're like "what does purging even mean here" — bestie, it means everything goes. Sit down, hydrate, let's get into it. ✨

---

🌸 SYNOPSIS 🌸

kas purge [-h] [--dry-run] [--isar-privileged | --isar-rootless]
          [--preserve-repo-refs]
          [config]

Yes the synopsis is that girl. We love a compact usage line. 🎀

---

🦋 DESCRIPTION 🦋

So basically: kas-purge purges all data managed by kas, and yes that includes the managed repos. No survivors. It's giving spring cleaning but make it nuclear. 💀

Here's the receipts on what actually gets cleared:

• the contents of the build directory
• sstate-cache
• downloads
• the repos managed by kas — including referenced repos inside KAS_REPO_REF_DIR, if that variable is set (if set, key detail, don't forget it)

And over in KAS_WORK_DIR? It removes the default configuration file, plus the KAS_BUILD_DIR if it happens to be present.

Now listen, if you want to keep your reference repositories alive (real ones know), run it with --preserve-repo-refs and they'll be spared. 🫶

⚠️ Heads up: this command requires a configuration file, because that's how it locates the managed repos. No config, no purge. Periodt.

📌 Note: Before purging, kas needs to checkout and resolve all repos to locate the repos managed by kas. So it's doing a whole little reconnaissance mission first, iconic behaviour honestly.

---

✨ OPTIONS ✨

🎯 Positional Arguments

• config — the config file(s), separated by a colon. If you don't specify one and a .config.yaml exists in KAS_WORK_DIR, it'll just use that one. Convenient?? yes. Surprising?? maybe a little. 🙈

💖 Named Arguments

• --dry-run=False — do not remove anything, just print out what would be removed. This is the "window shopping" mode. Main character energy, zero consequences. 👑
• --isar-privileged=False, --isar=False — use the ISAR (privileged) build directory layout.
• --isar-rootless=False — use the ISAR (rootless) build directory layout.
• --preserve-repo-refs=False — do not remove the reference repositories. Your little reference repos survive. Slay. 💅

🌈 psst: in the synopsis, --isar-privileged and --isar-rootless show up as mutually exclusive (|), so don't go picking both like it's a buffet.

---

👀 SEE ALSO 👀

Go read these next, they're all in the family:

• kas-plugin-clean
• kas-plugin-cleanall
• kas-plugin-cleansstate

---

💜 KAS

Part of the kas(1) suite. One big happy (and slightly chaotic) family. 🧚

---

🍓 Author

Daniel Wagner, Jan Kiszka, Claudius Heine

🎀 Copyright

Siemens and contributors, 2017-2025

---

and that's the whole page bestie!! this was kas-purge, documented in version 5.4, dated Jun 25, 2026, and it lives in the kas manual pages. go forth and purge responsibly (or --dry-run first, i am BEGGING you 😭) 💖✨🌸