Configuration

The server is configured with environment variables. Set them before npm start, or, on a Linux server installed with the deployment scripts, in /etc/autotestx.env followed by sudo systemctl restart autotestx.

Server

Variable	Default	Meaning
`HOST`	`127.0.0.1`	Interface to listen on. Keep `127.0.0.1` behind a reverse proxy.
`PORT`	`4100`	Port to listen on
`ATX_PUBLIC_URL`	`http://HOST:PORT`	The address people use to reach AutoTestX, e.g. `https://autotestx.example.com`. Password-reset links are built from it, never from the request’s Host header. An `https:` value also turns on secure cookies.
`ATX_SECURE_COOKIES`	off	`1` forces the `Secure` flag on session cookies (automatic when `ATX_PUBLIC_URL` is https)
`ATX_DATA_DIR`	`./.data`	Where all data is stored. See Data and backup.
`ATX_WEB_DIST`	`packages/web/dist`	The built web application to serve

Test execution

Variable	Default	Meaning
`ATX_POOL_SIZE`	`2`	Browser pages kept warm for interactive runs. Opening a new page is the slowest part of starting a run (several seconds); a warm pool makes runs start almost instantly. Each page costs memory: use `1` on a 2 GB server.
`ATX_MAX_ROW_CONCURRENCY`	`4`	Platform ceiling on parallel rows in a data-driven run, whatever the test asks for. Use `2` on a 4 GB server.
`ATX_HEADED`	off	`1` shows the browser for every server-side run (debugging on a desktop)

Visible browsers (Record, Pick, Watch)

Variable	Default	Meaning
`ATX_VISIBLE_BROWSER`	`auto`	Where visible browsers open. `local`: on the server’s own screen. `agent`: on the tester’s computer through the AutoTestX Agent (use for any hosted server). `auto`: the agent when the user has one connected, otherwise the server’s screen.
`ATX_AGENT_EXE`	`packages/agent/dist/AutoTestX-Agent.exe`	The agent installer offered at `/api/agent/download`

AI step writer

Variable	Default	Meaning
`ANTHROPIC_API_KEY`	not set	Turns on Write with AI. Without it the feature reports that it is not connected.

Deployment script

Variable	Used by	Meaning
`ATX_AGENT_SIGN_SCRIPT`	`deploy/deploy.ps1`	A PowerShell script that code-signs `AutoTestX-Agent.exe` before upload. Unset: the agent ships unsigned.

Example: production

HOST=127.0.0.1
PORT=4100
ATX_PUBLIC_URL=https://autotestx.example.com
ATX_DATA_DIR=/var/lib/autotestx
ATX_POOL_SIZE=2
ATX_MAX_ROW_CONCURRENCY=2
ATX_VISIBLE_BROWSER=agent
ATX_AGENT_EXE=/opt/autotestx/agent/AutoTestX-Agent.exe
# ANTHROPIC_API_KEY=sk-ant-…

This is deploy/autotestx.env.example, which the deployment installs as /etc/autotestx.env (readable by root only).

Sizing

Server memory	`ATX_POOL_SIZE`	`ATX_MAX_ROW_CONCURRENCY`
2 GB	1	1
4 GB	2	2
8 GB+	2–4 (suggested starting point)	4

The 2 GB and 4 GB values come from the deployment defaults. Memory per browser context depends heavily on the application under test, so watch the server’s memory under a realistic data-driven run before raising them.