rt-externa...ttachments(8)

🌸 NAME 🌸

rt-externalize-attachments — ok bestie, this is the little script that takes your attachments and moves them from the database over to some external storage. Moving day, but for blobs. 💅

It lives in section 8 of the Request Tracker Reference, so it's a sysadmin-adjacent command, not some lil userland toy. 👑

---

✨ SYNOPSIS ✨

rt-externalize-attachments [options]

That's it. That's the whole entrance. No arguments, just vibes and flags. 🦋

---

💖 DESCRIPTION 💖

So rt-externalize-attachments is the tool you reach for when you want to take attachments out of the database and park them in some external storage instead. That's literally its whole job. It's giving "decluttering my room" but make it infrastructure. 🧹✨

---

🎀 OPTIONS 🎀

• --age=AGE — if you pass an age, only the attachments older than AGE days get moved. Anything fresher stays put. And if you don't pass it at all? Default behaviour is that everything gets moved. No age filter, no survivors. 💀
• --batchsize=NUM — if you give it a batch size, only NUM attachments get moved. Cap it, queen. And again, default is that everything is moved. 👑
• --class=RT::Attachments or --class=RT::ObjectCustomFieldValues — pass a class and only objects of that specific class get externalized. Pick your fighter. 🥊
• --ids=NUM,NUM — use --ids along with --class to explicitly externalize the specific records you name. Not a solo act, bestie, it needs --class to ride with. 💫
• -h, --help — displays this documentation right there for you. Self-care. 🫶
• -v, --verbose — logs a message at level info for each attachment, both before its upload begins and after it completes. So you get a lil running commentary the whole way through. Narrator voice: on. 🎙️
• --dry-run — does a trial run and makes no changes at all, but mostly the same output as a real run gets produced. So you can peek without committing. And heads up: dry-run implies verbose output, so it's chatty whether you asked or not. 🙈

ngl, --dry-run is the main character here. Always do a trial run before you start yeeting your attachments into external storage, fr fr. 😭

---

🔥 SEE ALSO 🔥

• "External-storage" in RT_Config
• RT::ExternalStorage

---

periodt. that's the whole page. 💜

This one's from perl v5.40.1, dated 2026-06-21 — shoutout to the Request Tracker crew for keeping the docs alive, mwah. 🍓🧚