Skip to main content

Introduction to StagDB

Welcome to StagDB - an open-source tool that converts basic Ubuntu VMs into staging database servers with instant database provisioning and branching capabilities.

What is StagDB?​

StagDB transforms your infrastructure by providing:

  • Instant Database Provisioning: Deploy PostgreSQL, MySQL, and MongoDB instances in seconds using Docker containers
  • Database Branching: Create instant database branches using ZFS snapshots and clones for space-efficient testing
  • Isolation: Each database runs in its own Docker container with complete environment isolation
  • Self-Hosted: Full control over your staging infrastructure with no vendor lock-in

Key Features​

🚀 Instant Provisioning​

Convert any Ubuntu VM into a staging database server in minutes. No complex setup required.

🌳 Database Branching​

  • Create instant snapshots of your databases
  • Branch databases for testing without copying data
  • Space-efficient storage using ZFS technology

🔒 Complete Isolation​

  • Each database runs in its own Docker container
  • No interference between different database instances
  • Clean teardown when databases are no longer needed

📈 Scalable​

  • Support for multiple database types (PostgreSQL, MySQL, MongoDB)
  • Handle multiple teams and projects
  • Resource management and monitoring

Getting Started​

Ready to get started? Check out our Installation Guide to set up StagDB on your infrastructure.

Architecture Overview​

StagDB uses a modern containerized architecture:

  • Docker Containers: Provide database isolation and easy management
  • ZFS Storage: Enables instant snapshots and space-efficient branching
  • RESTful API: Programmatic access to all functionality
  • Web Dashboard: User-friendly interface for database management

Use Cases​

Development Teams​

  • Create isolated database environments for each feature branch
  • Test migrations safely before applying to production
  • Share database states between team members

QA Testing​

  • Quickly provision test databases with production-like data
  • Reset databases to known states between test runs
  • Parallel testing with multiple database branches

CI/CD Pipelines​

  • Integrate database provisioning into automated testing workflows
  • Ensure consistent test environments across pipeline runs
  • Clean up resources automatically after testing

Community & Support​

StagDB is an open-source project. Get involved:

License​

StagDB is released under the MIT License.