Run the LRS locally
Simplest Data Docs
Simplest Data Docs

#Run the LRS locally

Operating model: Local / self-managed

The simplestlrs CLI starts and operates an acquired LRS release in your environment.

#Start

Shell
simplestlrs start 1.0.1

The LRS is available at http://127.0.0.1:8000 by default. The first start may take longer while Docker downloads required runtime dependencies and initializes the environment.

PostgreSQL runs inside the Docker Compose stack and is not exposed on a public host port.

#Inspect

Shell
simplestlrs status
simplestlrs logs

status shows the configured release and service state. logs shows recent LRS logs. Use both when startup or readiness fails.

#Verify

Shell
curl -fsS http://127.0.0.1:8000/healthz
curl -fsS http://127.0.0.1:8000/readyz
curl -fsS http://127.0.0.1:8000/xAPI/about

healthz reports process liveness. readyz reports whether the LRS is ready to serve traffic. /xAPI/about reports the xAPI versions advertised by the LRS.

#Stop

Shell
simplestlrs stop

Stopping the LRS removes the running containers but preserves the PostgreSQL data volume. See persistence before reasoning about local data lifecycle.