FREECLOUD-CLI(1)

💖 FREECLOUD-CLI 💖

okay bestie, you know that one command from the User Commands part of the manual? That's this one. It's freecloud-cli, and it's literally here to synchronize files with a self-hosted FreeCloud drive. That's the whole vibe. No cloud corpo nonsense, just your own lil server and your own lil files, holding hands 🫶

---

✨ SYNOPSIS ✨

freecloud-cli [OPTION]...

That's it. That's the whole summoning ritual. Options only, no positional args, no drama 💅

---

🌸 DESCRIPTION 🌸

So freecloud-cli runs the FreeCloud synchronization client, right in your terminal, because terminals are iconic and we stay loyal to them 🎀

And here's the cute part: if there's no saved configuration sitting around anywhere, it doesn't just throw an error at you like some rude program. Nope. It kicks off the first-time setup prompts instead, walking you through it like a patient bestie helping you pick an outfit. First-run friendliness, no cap ✨

---

👑 OPTIONS 👑

• --config PATH — point it at the specific FreeCloud client configuration file you want it to use. You choose the file, it obeys. Main character energy fr 🦋
• --local FOLDER — use the local synchronization folder you name here instead of whatever default it'd grab otherwise 💖
• --once — run exactly one synchronization pass and then dip. One and done, no loitering, exit stage left 🚪✨
• --interval SECONDS — sets the polling interval, aka how often it checks back in with the remote. Heads up though: the minimum is two seconds, so don't try to be cute with 1. Two is the floor, periodt ⏱️
• --delete-remote — this one's spicy 🔥 It propagates your local deletions up to the remote server. So if you delete something locally, it goes bye-bye remotely too. Double-check before you yeet things, bestie 💀
• --version — shows you the FreeCloud version and exits. Quick little flex, then gone 🌈
• -h, --help — displays the command help and exits. Your safety net when you forget a flag (we all do, no shame) 🙈

---

🎀 FILES 🎀

• ~/.config/freecloud/last_config.json — the last-used configuration. It remembers what you last told it so you don't have to 🧚
• LOCAL_FOLDER/.freecloud_client.json — the configuration for a synchronized local folder. Yep, the config lives inside the folder it's syncing, lowkey cute 🍓

---

🌟 AUTHOR 🌟

Kyle Benzle <kbe@gmx.us> — thank you for your service, king 👑

---

🔥 SEE ALSO 🔥

• freecloud(1) — the main character of this franchise, go read it next 💜

---

ngl bestie, the docs are giving "short but mighty." Read the options, respect the two-second minimum, and think twice before --delete-remote. That's the whole lore. iykyk 💅

FreeCloud 2.1.1 — June 2026 🌈 That's the version and the date, babes, and this manual page for freecloud-cli is officially wrapped. Go sync something gorgeous 💖✨