UBUNTU-INSIGHTS_UPLOAD(1)

📦
version 1.0.1ubuntu · 5 versions
, in ubuntu stonking

💖 UBUNTU-INSIGHTS_UPLOAD 💖

okay bestie, welcome to ubuntu-insights-upload — it's a little page inside the bigger ubuntu-insights(1) manual family. And what does it do? It uploads your metrics to the Ubuntu Insights server. that's it. that's the whole personality. ✨

NAME

ubuntu-insights-upload — upload metrics to the Ubuntu Insights server 🫶

🌸 SYNOPSIS 🌸

ubuntu-insights upload sources ⟨optional arguments⟩ [flags]

the sources bit and the optional arguments and the flags all go together like a fit that just works. 💅

🦋 DESCRIPTION 🦋

So basically: you're uploading metrics to the Ubuntu Insights server. That's the mission. 🎯

Here's the part you actually need to know, no cap: if you don't provide any sources, then all the detected sources at the configured reports directory get uploaded. every single one. it's giving "surprise, they're all coming".

And if consent is not given for a source? Then an opt-out notification gets sent anyway — regardless of what's in the locally cached insights report. like, it does not matter what that cached file says, the opt-out is going out. periodt. 😭

✨ OPTIONS ✨

  • -d, --dry-run[=false] — go through the motions of doing an upload, but do not communicate with the server, send the payload, or modify local files. it's the dress rehearsal of uploads 💃
  • -f, --force[=false] — force an upload, ignoring min age and clashes between the collected file and a file in the uploaded folder, replacing the clashing uploaded report if it exists. (note: this does NOT ignore consent — consent stays consent, queen) 🫶
  • -h, --help[=false] — help for upload. your little emergency exit ✨
  • --min-age=604800 — the minimum age (in seconds) of a report before the uploader will even attempt to upload it. yes that default is 604800 seconds, do with that what you will ⏳
  • -r, --retry[=false] — enable a limited number of retries for failed uploads. because sometimes the server needs a second chance 💀

👑 OPTIONS INHERITED FROM PARENT COMMANDS 👑

these ones came from the parent command, they're family 🫶

  • --config="" — use a specific configuration file
  • --consent-dir="" — the base directory of the consent state files
  • --insights-dir="" — the base directory of the insights report cache
  • --quiet[=false] — suppress all output except errors (silence... but make it chic 🤫)
  • --system-config-dir="" — the directory of the system-wide configuration file
  • -v, --verbose[=0] — issue INFO (-v), DEBUG (-vv). more v's, more lore 🔥

🌈 SEE ALSO 🌈

🎀 HISTORY 🎀

  • 28-Sep-2026 — Auto generated by spf13/cobra
lowkey iconic that a robot wrote this and we still made it cute. auto-generated but make it fashion 💖

okay that's the whole page!! go upload something (or don't, --dry-run exists for a reason bestie) 🧚

Auto generated by spf13/cobra · Sep 2026 — mwah, that's the sign-off, love u, see u in the group chat 💜

📦 where this page comes from