Choud
- stack
- Self-hosting · FastAPI · C++ · PostgreSQL · Android
What it is#
Choud is a self-hosted alternative to Google Drive. It runs on one spare Linux machine at home, keeps your files on your own disk, and reaches your phone and laptops over Tailscale or your home network. There are no subscriptions, no tracking and no storage limit beyond the drive you give it.
You get folders and resumable uploads, a photo timeline, versions and a trash, search by file name and by what is written inside documents, public share links with an expiry and a password, an Android app that backs up photos, a desktop sync client, and an encrypted vault.
Why it exists#
I was tired of paying for storage while I had perfectly good hardware lying around the house. Instead of renting space in someone else's cloud, I wanted to turn what I already owned into a server. It also became a rule: build something one person can understand from end to end, so there is no Kubernetes, no microservices and nothing distributed.
How it works#
A Python API (FastAPI) owns accounts, permissions, versions, sharing and search, with PostgreSQL for metadata. A C++ engine owns the bytes: hashing, content-addressed storage, deduplication and chunk assembly, so uploading the same file twice stores it once. The engine is never exposed to the network; only the backend talks to it.
Uploads are chunked and hash-checked, so a dropped connection only resends what is missing. Overwrites become versions and deletes go to a trash, because the rule is never to destroy data on a doubt. The browser app is React, the phone app is Kotlin, and the desktop client is Python. For the full story with the mistakes, read how I built it.
Stack#
Python and FastAPI, C++, PostgreSQL, React, Kotlin for Android, Docker Compose with a Caddy proxy.
Status#
It runs on my own laptop server: a Lenovo with a 1 TB drive and 16 GB of RAM, Linux Mint, always plugged in. I started the idea around 28 or 29 August 2026 and worked on it for about six weeks, until roughly 11 October. Honest gaps from the repository: the Android app has had little time on a real phone, sharing with named accounts is deliberately not built (links are the only way to share), and there is no iOS app.