Overview

The Redgate Test Data Manager GUI provides an interface for managing test data operations.

This guide covers installation on Windows systems. A Docker image is also available in preview.

Requirements

Hardware requirements

Software requirements

Browser requirements

Supported browsers:
- Chrome (recommended)
- Edge
- Firefox

Before you begin

Ensure you have:

• Windows administrator privileges
• Two available ports (defaults: 443 HTTPS, 8080 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

Step 3: Destination folder

• Click Next to install to the default folder, or click Change to choose another location
• Default location: C:\Program Files\Red Gate\Test Data Manager\
• Click Next to continue 

Step 4: Configure ports

The application needs two ports:

To configure:

1. Enter port numbers or use defaults
2. Click Validate
3. Click Next after validation succeeds

Step 5: Install

• Click Install to begin installation (requires administrator privileges)
• Click Back to review or change any of your installation settings
• Click Cancel to exit the wizard
• Wait for the installation to complete

Step 6: Complete installation

• Launch Test Data Manager in browser is selected by default and will open the GUI automatically after finishing
• Click Finish
  

Step 7: Access the GUI

1. By default, the GUI will open automatically in your default browser 
   
   • If you deselected "Launch Test Data Manager in browser", open a supported browser (Chrome, Edge, Firefox) and go to https://localhost:443 (or your custom HTTPS port)
     
     Do not use Internet Explorer - it is not supported

2. Accept the certificate warning. Because Test Data Manager uses a self-signed SSL certificate by default, your browser will show a security warning on first access. This is expected behavior. To proceed:

   • Chrome/Edge: Click "Advanced" → "Proceed to localhost (unsafe)"
   • Firefox: Click "Advanced" → "Accept the Risk and Continue"
     
     

3. Wait for initial setup (first launch only)

   • On first launch, database migrations run automatically (1-2 minutes). You'll see: Application is not ready - Database is currently being migrated
   • Once complete, the Test Data Manager setup screen will appear.

Next Steps

See Configure the TDM UI to continue with initial configuration.