Device Variables
The Test Runner requires the following variables to be configured on the balena fleet, applied to All services. For instructions on adding them to your fleet, see Deploying to a Device.
Test Runner Variables
| Variable | Description | Value |
|---|---|---|
BACKEND_API_URL | Internal URL the services use to reach the Test Runner backend API. | https://backend:8888 |
BACKEND_CORS_ORIGINS | JSON array of origins allowed to make cross-origin (CORS) requests to the backend. | ["http://localhost", "http://localhost:8080"] |
CELERY_BROKER_URL | Message broker (RabbitMQ) URL Celery uses to queue and dispatch test tasks. | amqp://guest:guest@queue:5672/ |
FIRST_OPERATOR | Username for the default operator account created on first startup. | <operator-username> |
FIRST_OPERATOR_PASSWORD | Password for the default operator account. | <operator-password> |
FIRST_SUPERUSER | Username for the default admin (superuser) account created on first startup. | <admin-username> |
FIRST_SUPERUSER_PASSWORD | Password for the default admin (superuser) account. | <admin-password> |
POSTGRES_DB | Name of the PostgreSQL database used by the Test Runner. | app |
POSTGRES_PASSWORD | Password for the PostgreSQL user. | <db-password> |
POSTGRES_SERVER | Hostname of the PostgreSQL service container. | db |
POSTGRES_USER | Username for the PostgreSQL database. | postgres |
PROJECT_NAME | Display name shown for this Test Runner deployment. | <project-name> |
PYTEST_API_URL | Internal URL of the pytest-f3ts-api service. | http://pytest-f3ts-api:8886 |
REFRESH_PLANS | Reload test plans from TEST_PLAN_DIR on startup (1 = enabled, 0 = disabled). | 1 |
SECRET_KEY | Secret key used to sign authentication tokens and other cryptographic operations. | <your-secret-key> |
SENTRY_DSN | Sentry DSN for error reporting; leave empty to disable. | (empty) |
START_SSHD | Start the SSH daemon for remote access to the device (1 = enabled). | 1 |
TEST_PLAN_DIR | Filesystem path where test plans are stored on the device. | /data/test_plans |
WEB_CONCURRENCY | Number of web server worker processes to run. | 1 |
Values shown as <placeholders> must be replaced with your own. In particular, set unique secrets for SECRET_KEY, FIRST_SUPERUSER_PASSWORD, FIRST_OPERATOR_PASSWORD, and POSTGRES_PASSWORD rather than reusing values across fleets.