mirror of
https://github.com/bitwarden/server
synced 2026-01-30 16:23:37 +00:00
Bitwarden Database Seeder Utility
A command-line utility for generating and managing test data for Bitwarden databases.
Overview
DbSeederUtility is an executable wrapper around the Seeder class library that provides a convenient command-line interface for executing seed-recipes in your local environment.
Installation
The utility can be built and run as a .NET 8 application:
dotnet build
dotnet run -- <command> [options]
Or directly using the compiled executable:
DbSeeder.exe <command> [options]
Examples
Generate and load test organization
# Generate an organization called "seeded" with 10000 users using the @large.test email domain.
# Login using "owner@large.test" with password "asdfasdfasdf"
DbSeeder.exe organization -n seeded -u 10000 -d large.test
# Generate an organization with 5 users and 100 encrypted ciphers
DbSeeder.exe organization -n TestOrg -u 5 -d test.com -c 100
# Generate with Spotify-style collections (tribes, chapters, guilds)
DbSeeder.exe organization -n TestOrg -u 10 -d test.com -c 50 -o Spotify
# Generate a small test organization with ciphers for manual testing
DbSeeder.exe organization -n DevOrg -u 2 -d dev.local -c 10
Options
| Option | Description |
|---|---|
-n, --name |
Organization name |
-u, --users |
Number of member users to create |
-d, --domain |
Email domain (e.g., test.com creates owner@test.com) |
-c, --ciphers |
Number of encrypted ciphers to create (optional) |
-o, --org-structure |
Collection structure: Traditional, Spotify, or Modern (optional) |
Notes
- All users are created with the password
asdfasdfasdf - The owner account is always
owner@{domain}with Confirmed status - Member accounts are
user0@{domain},user1@{domain}, etc. - Without
--org-structure, a single "Default Collection" is created - With
--org-structure, collections are created from org model (e.g., Spotify creates tribes, chapters, guilds) - Ciphers are encrypted and distributed across collections using dynamically generated organization keys
Dependencies
This utility depends on:
- The Seeder class library
- CommandDotNet for command-line parsing
- .NET 8.0 runtime