# cloudy
Cloudy is a self-hosted files hub for personal use and small teams, written in Rust with Axum. Think of the Nextcloud-shaped hole in your life: files with sharing, versions and resumable uploads, plus the groupware around them, but smaller, opinionated, and honest about what it is. Right now that honesty includes the fact that it’s a working development alpha — not a business-ready Nextcloud replacement yet.
The files part is the core: your own Files home, Nextcloud-style folder creation, incoming shares alongside your own files, per-folder sharing, quotas, and optional encryption at rest with ClamAV scanning and retention policies. Around it live the built-in apps — Mail against your existing IMAP/SMTP accounts, Calendar and Tasks with two-way CalDAV sync, Contacts with CardDAV, Notes, Bookmarks and Forms — all rendered in the same app rail with no separate services or ports. File comments, mentions, tags, albums, document and OCR search, booking links and room reservations are in too.
If you want an AI in the mix, the assistant uses an OpenAI key configured on your own server, searches only data you’re authorized to see, and prepares changes for review instead of doing things behind your back. Administration is covered as well: a settings console and CLI for users, groups, quotas and the audit log, sign-in via OpenID Connect, LDAP, passkeys or authenticator apps, and an interface available in English, German, French, Spanish and Dutch. There’s even an installable app platform — JavaScript in bounded workers with an explicit capability contract — for the things I didn’t think of.
Deployment is deliberately boring: Docker Compose with just PostgreSQL, no Redis, no external object store. A FUSE drive prototype mounts your space in a local file manager, and a separate desktop client gives you a synced folder with a tray icon. The full Compose deployment hasn’t been validated yet and several release gates remain, so run it because you enjoy self-hosting, not because you bet your organization on it. The code is on the forge.
~$