Bitwarden-compatible server running on Cloudflare Workers
Telegram Channel | Telegram Group
Disclaimer
This project is for learning and discussion purposes only. Please back up your vault regularly.
This project is not affiliated with Bitwarden. Please do not report NodeWarden issues to the official Bitwarden team.
| Capability | Bitwarden | NodeWarden | Notes |
|---|---|---|---|
| Web Vault | ✅ | ✅ | Original Web Vault interface |
Full sync /api/sync | ✅ | ✅ | Compatibility optimized for official clients |
| Attachment upload / download | ✅ | ✅ | Cloudflare R2 or KV |
| Send | ✅ | ✅ | Supports both text and file Sends |
| Import / Export | ✅ | ✅ | Supports Bitwarden JSON / CSV / ZIP import with attachments |
| Cloud Backup Center | ❌ | ✅ | Scheduled backup to WebDAV / E3 |
| Password hint (web) | ⚠️ Limited | ✅ | No email required |
| TOTP / Steam TOTP | ✅ | ✅ | Includes steam:// support |
| Multi-user | ✅ | ✅ | Invite-based registration |
| Organizations / Collections / Member roles | ✅ | ❌ | Not implemented |
| Login 2FA | ✅ | ⚠️ Partial | Currently only user-level TOTP |
| SSO / SCIM / Enterprise directory | ✅ | ❌ | Not implemented |
- ✅ Windows desktop client
- ✅ Mobile app
- ✅ Browser extension
- ✅ Linux desktop client
- ⚠️ macOS desktop client has not been fully verified yet
- Fork this repository. If this project helps you, consider giving it a Star.
- Open Workers ->
Continue with GitHub-> select your forked repository (NodeWarden) -> continue. - R2 is used by default. If R2 is not enabled on your account, you can use KV instead by changing the deploy command to
npm run deploy:kv. - Deploy and open the generated URL.
| Storage | Card required | Single attachment / Send file limit | Free tier |
|---|---|---|---|
| R2 | Yes | 100 MB (soft limit, adjustable) | 10 GB |
| KV | No | 25 MiB (Cloudflare limit) | 1 GB |
TIP
How to keep your fork updated:
- Manual: open your fork on GitHub, click
Sync fork, thenUpdate branch - Automatic: go to your fork ->
Actions->Sync upstream->Enable workflow; it will sync upstream automatically every day at 3 AM
git clone https://github.com/shuaiplus/NodeWarden.git
cd NodeWarden
npm install
npx wrangler login
# Default: R2 mode
npm run deploy
# Optional: KV mode
npm run deploy:kv
# Local development
npm run dev
npm run dev:kv
- Remote backup supports WebDAV and E3
- When
Include attachmentsis enabled: - the ZIP still contains only
db.jsonandmanifest.json - actual attachment files are stored separately under
attachments/ - later backups reuse existing attachments by stable blob name instead of re-uploading everything every time
- During remote restore:
- required attachment files are loaded from
attachments/on demand - missing attachments are skipped safely
- skipped attachments do not leave broken rows in the restored database
Current supported import sources include:
- Bitwarden JSON
- Bitwarden CSV
- Bitwarden vault + attachments ZIP
- NodeWarden JSON
- Multiple browser / password-manager formats available in the web import selector
Current supported export formats include:
- Bitwarden JSON
- Bitwarden encrypted JSON
- ZIP export with attachments
- NodeWarden JSON variants
- Full manual instance export from the backup center
LGPL-3.0 License
- Bitwarden - Original design and clients
- Vaultwarden - Server implementation reference
- Cloudflare Workers - Serverless platform
35/F,Tencent Building,Kejizhongyi Avenue,Nanshan District,Shenzhen
