中文文档：README_ZH.md
A Bitwarden-compatible server that runs on Cloudflare Workers, designed for personal use.
- Simple deploy (no VPS)
- Focused feature set
- Low maintenance
Disclaimer
- This project is not affiliated with Bitwarden.
- Use at your own risk. Keep regular backups of your vault.
- ✅ Free to use. No server to manage.
- ✅ Full support for logins, notes, cards, and identities
- ✅ Folders and favorites
- ✅ Attachments (Cloudflare R2)
- ✅ Import / export
- ✅ Website icons
- ✅ End-to-end encryption (the server can’t see plaintext)
- ✅ Compatible with common Bitwarden official clients
- ✅ Windows desktop client（v2026.1.0）
- ✅ Android app （v2026.1.0）
- ✅ Browser extension（v2026.1.0）
- ⬜ macOS desktop client (not tested)
- ⬜ Linux desktop client (not tested)
Deploy steps:
- Sign in with GitHub and authorize
- Sign in to Cloudflare
- Important: set
JWT_SECRETto a strong random string (recommended:openssl rand -hex 32) - KV namespace and R2 bucket will be created automatically
- Click Deploy and wait for it to finish
- After deploy, open the Cloudflare-provided Workers URL (your service URL), and register on the web page
⚠️ Reminder: always use a strong randomJWT_SECRET. Weak secrets may put your account at risk.
In any Bitwarden client:
- Open Settings
- Choose Self-hosted environment
- Set Server URL to your Worker URL (for example:
https://your-project.your-subdomain.workers.dev) - Save, then go back to the login screen
This repo is a Cloudflare Workers TypeScript project (Wrangler).
npm install
npm run dev- Runtime: Cloudflare Workers
- Data storage: Cloudflare KV
- File storage: Cloudflare R2
- Language: TypeScript
- Crypto: Client-side AES-256-CBC, JWT uses HS256
Q: How do I back up my data?
A: Use Export vault in your client and save the JSON file.
Q: What if I forget the master password?
A: It can’t be recovered (end-to-end encryption). Keep it safe.
Q: Can multiple people use it?
A: Not recommended. This project is designed for single-user usage.
LGPL-3.0 License
- Bitwarden - original design and clients
- Vaultwarden - server implementation reference
- Cloudflare Workers - serverless platform