Overview

The Redgate Test Data Manager GUI provides an interface for managing test data operations. This guide covers installation on Windows systems.

Requirements

Hardware requirements

Software requirements

Before you begin

Ensure you have:

• Windows administrator privileges
• Two available ports (defaults: 8080 HTTPS, 8081 HTTP)

Step 1: Download the installer

• Download the TDM Hub GUI installer from our download page.
• Extract the zip file
• Locate the .msi file - This is your installer

Step 2: Run the installer 

• Right-click the .msi file and select Run as administrator
• Click Next on the Welcome screen
• Accept the EULA and click Next

Step 3: Configure port

The application needs two ports:

To configure:

1. Enter port numbers or use defaults
2. Click Allow when Windows requests network access (needed for port validation)
3. Click Next after validation succeeds

Step 4: Set passwords

SSL Certificate Password

1. Create a password for the self-signed certificate
2. Record this password securely

GUI Login Password

1. Create a password for GUI access
2. Click Next

Step 5: Install

• Click Install (requires administrator privileges)
• Wait for completion
• Click Finish

Step 6: (Optional) Switch to a SQL Server backing database

If you want to use a SQL Server backing database instead of Sqlite, see Switching to a SQL Server backing database

Step 7: Access the GUI

1. Open a browser
2. Go to https://localhost:8080 (or your custom HTTPS port)
3. Accept the certificate warning (expected with self-signed certificates)

On first launch, database migrations run automatically (1-2 minutes). You'll see: "Application is not ready - Database is currently being migrated"

Once complete, you can verify the installation by hovering over the application name in the top-left to check the version number.

Step 8: Activate your license

When you first launch the application, a licensing wizard guides you through setup:

1. Generate Personal Access Token - Click "Generate Token" to access the Redgate Licensing Portal and create a PAT
2. Set Environment Variables - Enter your email and the token you generated
3. Allocate License - Allocate your license or start a free trial