FREECLOUD(1)

💖 FREECLOUD 💖

okay bestie, so this is freecloud — it's in section 1 of the manual (User Commands, iykyk) and it is literally the tool that syncs your files with a self-hosted FreeCloud drive. no cap. 🦋

---

✨ NAME ✨

freecloud — synchronize files with a self-hosted FreeCloud drive 🎀

---

🌸 SYNOPSIS 🌸

freecloud

that's it. that's the whole synopsis. no flags, no args, no chaos. she just launches. 💅

---

🫶 DESCRIPTION 🫶

okay so picture this: FreeCloud is a desktop file browser and synchronization client for a FreeCloud installation that's hosted in a PHP-enabled web account. yes, PHP. we contain multitudes. 🌈

On the first launch (the main character moment ✨), you're gonna:

1. enter the full website address of the hosted installation 🌐
2. choose a local synchronization folder 📁
3. optionally enter a password 🔐

and then she's off. obsessed. 💖

---

📁 FILES 📁

these are the little guys she keeps around, bestie, know them, love them:

• ~/.config/freecloud/last_config.json — the last-used desktop configuration 🎀
• ~/.local/state/freecloud/ — logs, process state, and the cached remote file tree 🪵
• LOCAL_FOLDER/.freecloud_client.json — the configuration for a synchronized local folder 💅
• LOCAL_FOLDER/.freecloud_state.json — the synchronization state for a local folder 🔥

---

🔐 SECURITY 🔐

okay so listen, this part is Important with a capital I. 😭

The desktop client currently stores the configured password in a local JSON configuration file. fr fr. that's just what it does right now.

So before you go using FreeCloud with sensitive data, pleaseee go review the security notes in the installed README. not me begging you to read the README but like... read the README. 🙈

---

👑 AUTHOR 👑

Kyle Benzle <kbe@gmx.us> — legend behavior, honestly. 🌟

---

🌸 SEE ALSO 🌸

Project website, bestie, go look: https://freecloud.wiki 🦋

---

and that's the whole page, gorgeous. this was FreeCloud 2.1.1, dated June 2026, and yeah — that's FREECLOUD(1), page one of one, slay. 💜✨