TestRift Server (testrift-server)

Python server for TestRift real-time test runs: live log streaming, result storage, and a web UI for browsing and analysis.

Experimental

TestRift is currently in an experimental phase. APIs, configuration, and data formats may change at any time without notice.

Install

pip install testrift-server

Run

testrift-server

Or:

python -m testrift_server

Docker

All Docker-related files live in docker/.

Build the image:

docker build --network=host -f docker/Dockerfile -t testrift-server:latest .

Run a container (host networking — the server binds directly to host port 8080):

docker run -d \
  --name testrift-server \
  --network=host \
  -v testrift-data:/data \
  testrift-server:latest

Using Docker Compose (from the project root):

docker compose -f docker/docker-compose.yml up -d

Or from the docker/ directory:

cd docker && docker compose up -d

The server will be available at http://localhost:8080. Data is persisted in the testrift-data Docker volume.

To use a custom config, mount it over the default one:

docker run -d \
  --name testrift-server \
  --network=host \
  -v /path/to/your/testrift_server.yaml:/app/testrift_server.yaml:ro \
  -v testrift-data:/data \
  testrift-server:latest

Or set the TESTRIFT_SERVER_YAML environment variable to an absolute path inside the container.

Configuration

• The server loads configuration from either:
  • testrift_server.yaml in the directory you run testrift-server from, or
  • TESTRIFT_SERVER_YAML (a filesystem path to a YAML config file; absolute path recommended). If set, the server will fail to start if the file does not exist.

For the full configuration reference, see server_config.md.