COMPOSER-CLI(1)

📦
version 36.2 · 6 versions
, in fedora 44

COMPOSER-CLI 💖 (section 1, bestie — general commands)

okay so bestie, welcome to composer-cli, and specifically the part of it that handles sources. this is your group chat for talking to the server, and today we're talking about adding a project source. let's go 💅

✨ NAME ✨

composer-cli-sources-add — Add a project source to the server 🫶

🌸 SYNOPSIS 🌸

composer-cli sources add SOURCE.toml [flags]

yes queen, that's the whole shape of it. one <SOURCE.toml> file, and whatever <flags> you wanna throw at it.

🦋 DESCRIPTION 🦋

Add or change a project source repository. that's it, that's the vibe. new source? cool. tweaking an existing one? also cool. same command, no drama. ✨

💖 OPTIONS 💖

  • -h, --help[=false] — help for add. you already knew that tho. defaults to false bc obviously you didn't ask for help yet 🙈

👑 OPTIONS INHERITED FROM PARENT COMMANDS 👑

these are the ones your source add command borrowed from its parent, and they are lowkey the main character energy of this whole page:

  • -a, --api=1 — the WELDR Server API Version to use. default is 1, she's the blueprint 💜
  • --cloudsocket="/run/cloudapi/api.socket" — the path to the cloudapi server's socket file. that's where she lives, fr fr.
  • -j, --json[=false] — output the raw JSON response instead of the normal output. defaults to false, so you get the pretty version unless you specifically ask for the raw one 🍓
  • --log="" — path to an optional logfile. empty by default, so no logfile unless you say so.
  • -s, --socket="/run/weldr/api.socket" — the path to the WELDR API server's socket file. yes, it's a different socket from the cloudsocket one. two sockets, two vibes, don't mix them up 💀
  • --test=0 — pass test mode to compose. 1=Mock compose with fail. 2=Mock compose with finished. default is 0, i.e. no test mode, i.e. the real thing.
  • --timeout=240 — timeout to use for server communication. set to 0 for no timeout. so 240 is your default patience level, and 0 means "we wait forever, bestie" 😭
  • --weldr-only[=false] — only use the WELDR API; skip using the newer Cloud API. defaults to false, meaning by default she'll reach for the newer Cloud API too. if you want the old-school only route, flip this on.
ngl, the --weldr-only / --cloudsocket / --socket trio is giving "which API am i even talking to" energy. just read the flags twice and you'll be fine 🫶

🌈 EXAMPLE 🌈

composer-cli sources add rpmfusion.toml

look at her go. iconic. periodt. ✨

🎀 SEE ALSO 🎀

⭐ HISTORY ⭐

28-Apr-2026 — Auto generated by spf13/cobra. so like, technically a robot wrote this, and we're just here to make it cute 💅

and that's the whole page!! this was composer-cli from Apr 2026, page COMPOSER-CLI(1) — stay hydrated, read your manpages, and slay the source config bestie 🧚💖

📦 where this page comes from