Jira Data Center Toolkit – Universal Edition

A toolkit for deploying and managing Jira Data Center environments with Docker. For plugin developers, QA engineers, and teams who need reliable, isolated testing environments without cloud access or complex infrastructure.

📦 What you get

• Deploy any Jira Data Center version locally with one command

• Support for Oracle, PostgreSQL, MySQL, and MSSQL with version-specific configurations

• Cluster management: start, stop, and scale multi-node clusters

• Demo data generation: create users, projects, issues, and groups for testing

• Multi-instance support: run multiple Jira instances simultaneously

• Backup and restore: full backups and migration workflows

• Real-time logging and monitoring

• Three CLI options: Bash (lightweight), Node.js (interactive), Python (ecosystem-friendly)

⭐ Key features

🚀 One-command deployment

• Deploy a full Jira Data Center cluster with database in minutes:

"jira deploy --jira-version 9.17.0 --db-type postgresql --db-version 15"

🗄 Multi-database support

• Oracle 18c, 19c, 23ai

• PostgreSQL 10-17

• MySQL 5.6, 5.7, 8.0, 8.4

• MSSQL 2017, 2019, 2022

🧪 Advanced testing

• Generate realistic test data (users, projects, issues, groups)

• Test plugin compatibility across versions

• Performance testing with large datasets

• Isolated environments per test scenario

🏭 Production-like environments

• Multi-node cluster support

• Real backup and restore workflows

• Database migration support

💾 Backup & Migration System

🔄 Two Migration Methods:

Full DB Migration (Fast & Complete)

• Lightning-fast: Direct database dump/restore

• 1:1 state transfer: Preserves everything exactly as-is

• Use when: Source and target use the same database engine (e.g., PostgreSQL → PostgreSQL, MySQL → MySQL)

• Creates: Complete database dumps with all data, configurations, and metadata

• Perfect for: Version upgrades, environment replication, quick restores

Cross-DB Migration (Flexible & Universal)

• Database-agnostic: Works across different database engines

• XML-based: Uses Jira's native XML export/import format

• Use when: Migrating between different database types (e.g., MySQL → PostgreSQL, Oracle → MSSQL)

• Creates: entities.xml (issues, projects, workflows) and activeobjects.xml (plugin data)

• Perfect for: Database engine migrations, platform changes, standardized backups

📦 Backup Types

Sandbox Backup (From Running Instance)

• Creates a complete backup from your running Docker Jira instance

• Includes: Database dump, attachments, avatars, plugins, customizations, and configurations

• Automatic: Extracts everything directly from active containers

• Ready to restore: Push backup to any environment instantly

Production Backup Template (Structure for Real Data)

• Creates organized folder structure with placeholders

• Instructions included: Know exactly where to place your production files

• Flexible: Replace placeholders with your actual production backups

• Safe: Test production data locally without affecting production systems

🚀 Push Backup Feature

• Load prepared backups into any Docker environment

• Smart detection: Automatically finds compatible Jira instances

• Validation: Ensures backup compatibility before restoration

• Supports both migration methods: Full DB and Cross-DB

• One command: "jira push-backup" and you're done!

💡 Use Cases

Scenario 1: Testing Production Data Locally

1. Create production backup template

1. Replace placeholders with your production data

1. Push backup to your local Docker environment

1. Test safely without touching production

Scenario 2: Database Migration Testing

1. Backup your MySQL-based Jira (cross-DB migration)

1. Deploy new PostgreSQL-based instance

1. Push backup and verify migration

1. Test compatibility before production migration

Scenario 3: Version Upgrade Validation

1. Backup current Jira 8.x instance (full DB migration)

1. Deploy new Jira 9.x instance with same database

1. Restore backup and test upgrade compatibility

1. Validate all features before production upgrade

💻 Platform support

• 🐧 Linux (full native support)

📋Requirements

• 🐳 Docker Engine

• 🖥️ One of: Bash (no additional deps), Node.js ≥18.17.0, or Python ≥3.8

🎁 Why This Tool

• ⏱️ Save time — automated setup vs. manual configuration

• 🔄 Test across versions and databases easily

• 🔒 Isolated environments — no conflicts between projects

• 🏭 Production-ready workflows — realistic testing scenarios

• 💾 Professional backup system — safe migration and restore

✅ Perfect For

• 🔌 Plugin development and testing

• 🧪 QA automation and testing

• 📊 Performance testing and benchmarking

• 🗄️ Database migration testing

• 📚 Training and demos

• 💡 Proof of concept development

• 🔄 Production data testing in safe environments