How dani-garcia/vaultwarden works
Vaultwarden is a self-hosted Bitwarden-compatible API server. Official clients send authenticated requests to Rocket routes, which validate identity and security requirements, execute vault, sharing, organization, Send, emergency-access, or administration operations, persist state, and return JSON results. Optional flows integrate with SMTP, push services, Duo, OIDC, WebAuthn, website-icon providers, and S3-compatible storage. The graph emphasizes documented capabilities and sampled module boundaries; several route implementations were not inspected, so unsupported internal call chains are omitted.
Main entry points: db/mod.rs Application Database · core/mod.rs Core API Routes · two_factor/mod.rs Two-Factor Auth · http_client.rs HTTP Client
Components 26
API Surface
- Core API Routes
src/api/core/mod.rs - Admin Routes
src/api/admin.rs - Web Routes
src/api/web.rs - Notifications
src/api/notifications.rs - Push Service
src/api/push.rs
Vault Domains
- Personal Vault
src/api/core/ciphers.rs - Folders
src/api/core/folders.rs - Secure Sends
src/api/core/sends.rs - Organizations
src/api/core/organizations.rs - Collections Sharing
src/db/models/collection.rs - Emergency Access
src/api/core/emergency_access.rs
Identity Security
- Authentication
src/auth.rs - Two-Factor Auth
src/api/core/two_factor/mod.rs - WebAuthn
src/api/core/two_factor/webauthn.rs - SSO Login
src/sso.rs
Persistence
- Application Database
src/db/mod.rs - File Storage
src/storage.rs - Maintenance Jobs
src/main.rs
External Integrations
- HTTP Client
src/http_client.rs - Email Delivery
src/mail.rs
Other components
- Bitwarden Clients
- Admin Operator
- OIDC Provider
- Duo Service
- S3 Storage
- Icon Provider
Connections 34
- Bitwarden Clients → Core API Routes: sends requests
- Bitwarden Clients → Web Routes: loads web UI
- Admin Operator → Admin Routes: manages server
- Core API Routes → Authentication: authenticates
- Core API Routes → Personal Vault: dispatches vault
- Core API Routes → Folders: dispatches folders
- Core API Routes → Secure Sends: dispatches sends
- Core API Routes → Organizations: dispatches orgs
- Core API Routes → Emergency Access: dispatches access
- Organizations → Collections Sharing: manages sharing
- Authentication → Application Database: reads users
- Personal Vault → Application Database: reads and writes
- Folders → Application Database: reads and writes
- Secure Sends → Application Database: reads and writes
- Organizations → Application Database: reads and writes
- Collections Sharing → Application Database: reads and writes
- Emergency Access → Application Database: reads and writes
- Two-Factor Auth → Application Database: stores factors
- WebAuthn → Application Database: stores challenges
- Core API Routes → Two-Factor Auth: dispatches 2FA
- Two-Factor Auth → Email Delivery: sends codes
- Two-Factor Auth → Duo Service: verifies Duo
- WebAuthn → HTTP Client: uses transport
- SSO Login → HTTP Client: executes OIDC
- SSO Login → Application Database: stores login state
- SSO Login → OIDC Provider: discovers identity
- Admin Routes → Application Database: reads and writes
- Core API Routes → File Storage: stores attachments
- File Storage → S3 Storage: accesses objects
- Core API Routes → HTTP Client: fetches icons
- HTTP Client → Icon Provider: requests icons
- Notifications → Email Delivery: delivers notices
- Notifications → Push Service: dispatches pushes
- Maintenance Jobs → Application Database: purges records