# Director Service

## Common Configuration

`PORT=1234`

Director will listen on that port

`DASHBOARD_URL="http://localhost:8080"`

"Run URL" shown by Cypress agent when running tests

`INACTIVITY_TIMEOUT_SECONDS=180`

Director uses the timeout value to define how long we should wait before checking for a run’s inactivity.

`ALLOWED_KEYS=null`

List of comma delimited record keys (provided to the Cypress Runner using --key option) which are accepted by the director service.

This can be useful when cypress is running on external CI servers and we need to expose director to the internet.

Empty or not provided variable means that all record keys are allowed.

`GITLAB_JOB_RETRIES=false`

Enables/disables the ability to retry tests by rerunning CI jobs on GitLab.

This functionality is only supported when using the mongo execution driver.

`BASE_PATH="/"`

Service's base path, useful for reverse proxies

## Persistence Configuration

`EXECUTION_DRIVER="../execution/in-memory"`

Set the execution driver for Director service. Possible values are:

* `../execution/in-memory` - Director will keep all the data in-memory. See [Basic Setup](/configuration/in-memory.md).
* `../execution/mongo/driver` - use MongoDB as a persistence. See [Full Setup](/configuration/persistent.md#director-service).

## MongoDB Configuration

Used when mogo persistence configuration is selected. Refer to [MongoDB Configuration](/configuration/mongodb-configuration.md).

## Remote Storage Configuration

`SCREENSHOTS_DRIVER="../screenshots/dummy.driver"`

Set the execution driver for Director service. Possible values are:

* `../screenshots/dummy.driver` - don't store anything, dummy driver
* `../screenshots/s3.driver` - use AWS S3. See [Full Setup](/configuration/persistent.md#director-service) for details.
* `../screenshots/minio.driver`- use Minio. See [Full Setup](/configuration/persistent.md#director-service) for details.
* `../screenshots/azure-blob-storage.driver`- use Minio. See [Full Setup](/configuration/persistent.md#director-service) for details.
*

### AWS S3 Remote Storage Configuration

Refer to [AWS S3 Configuration.](/configuration/director-configuration/aws-s3-configuration.md)

### Minio Configuration

Read [Minio Configuration](/configuration/director-configuration/minio-configuration.md) for Director

### Azure Blob Storage Configuration

Refer to [Azure Blob Storage Configuration](/configuration/director-configuration/azure-blob-storage-configuration.md)

## Probe logs

`PROBE_LOGGER=false`

Enable or disable Director healthchecks logs.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sorry-cypress.dev/configuration/director-configuration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.