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

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 ttps://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.