Self-Hosted Runner Mock

Runner mock provides a self-hosted mock service for teams requiring mock endpoints in private networks or intranets. When a request is made to a runner mock URL, the request is sent to your self-hosted runner server, which generates and returns the mock response.

Prerequisites

Before configuring runner mock:

A deployed runner on your server or intranet (see deploying the Runner)

Team or project admin permissions

Access to team resources settings

Runner mock is ideal for teams that need mock services in private networks or for large-scale automated testing scenarios.

Configuration Steps

1. Configure the Server Host

Navigate to Team Resources → General Runner

Locate your deployed runner

Enter the IP address or domain of your runner server in the Server Host field

Server Host Examples:

Example 1

Example 2

2. Verify the Runner Mock Environment

After configuration, confirm the runner mock environment is available:

Navigate to Environment Management in your project

Check that the Runner Mock environment appears in the list

If properly configured, the runner mock environment will be visible and selectable.

3. Use the Runner Mock Environment

To send requests to your runner mock server:

Open the endpoint you want to test

Select the Runner Mock environment from the environment dropdown

Send the request

The request will be routed to your runner server, which will return the generated mock response.

FAQ

Does Runner Mock support HTTPS? How can I enable it?

Yes, runner mock can be accessed via HTTPS, but note the following:

Important Details:

The runner itself does not include built-in HTTPS certificate support or automatic certificate provisioning

If your domain is already configured with HTTPS (e.g., via a reverse proxy like Nginx with a certificate), you can use it directly

Configuration:

Simply enter https://your-domain:port in the Server Host field to access the runner mock service over HTTPS. No additional runner configuration is needed.

Example:

Self-Hosted Runner Mock

Prerequisites#

Configuration Steps#

1. Configure the Server Host#

2. Verify the Runner Mock Environment#

3. Use the Runner Mock Environment#

FAQ#

Prerequisites

Configuration Steps

1. Configure the Server Host

2. Verify the Runner Mock Environment

3. Use the Runner Mock Environment

FAQ