Skip to content

Access TestGen from Another Machine

Configure TestGen so that users, AI clients, and integrations can reach it from machines other than the TestGen server. By default, TestGen expects to be reached at localhost.

Set the base URLs

Set these variables to the URLs at which other machines reach TestGen, using the https scheme if TestGen is served over HTTPS.

Variable Default Purpose
TG_UI_BASE_URL http://localhost:8501 The UI URL, used in links in email notifications and PDF reports.
TG_BASE_URL http://localhost:8530 The API and MCP server URL. Required for AI clients and OAuth clients on other machines.

  1. Navigate to the directory that contains the docker-compose.yml file for TestGen.

    • If the instance was installed using dk-installer.exe, the file can be located under "AppData\Local\DataKitchenApps".
    • If the instance was installed using dk-installer, the file can be located in the folder from which the Python installer was executed.

  2. Add the following lines under the x-common-variables section, using the host ports from the engine service's ports section.

    x-common-variables: &common-variables
 TG_UI_BASE_URL: http://<host>:8501
 TG_BASE_URL: http://<host>:8530

  3. Restart the application.

    docker compose up -d --wait

  1. Open the ~/.testgen/config.env file in a text editor.

  2. Add the following lines (one variable per line, no quotes).

    TG_UI_BASE_URL=http://<host>:8501
TG_BASE_URL=http://<host>:8530

  3. Restart the application. Stop the running TestGen process with Ctrl+C in the terminal where it is running, then start it again.

    python3 dk-installer.py tg start

  1. Open the values-tg-app.yaml file used for the installation.

  2. Add the following under the testgen section.

    testgen:
  uiBaseUrl: https://<UI domain>
  baseUrl: https://<API domain>

  3. Apply the change.

    helm upgrade -n datakitchen dk-tg-app datakitchen-testgen/testgen \
    --values values-tg-app.yaml --wait

Open the ports

On a Docker or pip install, open the UI port and the API and MCP port, 8501 and 8530 by default, in the firewall or security group of the TestGen server. On Kubernetes, the ingress publishes both.