LRS Endpoints & Health

Manage NELC connection targets

What is an endpoint?

An endpoint is a complete NELC LRS target: URL, credentials, platform metadata, and sandbox flag. Each outbox row is tagged with an endpoint ID so the dispatcher always sends to the correct LRS.

Built-in endpoints

ID	Purpose	Default URL
`staging`	Sandbox — testing & portal validation	`lrs-license-stg/xapi/statements`
`production`	Live NELC LRS after approval	`lrs-license/xapi/statements`

Seeded from .env on first run. Editable in UI; cannot be deleted.

Active environment

The active endpoint determines:

Which LRS the poller tags on new outbox items
Which credentials Test LRS and Send Journey use
The badge in the admin header

Switching to a production (non-sandbox) endpoint requires confirmation.

Custom endpoints

Use + Add Endpoint for backup staging URLs, DR targets, or testing. Slug rules: lowercase, starts with a letter, 2–49 chars (a-z, 0-9, -, _).

Health status

Status	Meaning
Healthy	LRS reachable; auth OK (HTTP 200 or 409)
Unhealthy	Timeout, network error, or HTTP error (e.g. 401)
Not configured	Missing URL, username, or password
Unknown	Never checked, or credentials changed since last check

Health checks send a lightweight probe — they do not write to the outbox. Use Check All Health or per-endpoint Health button.

Enable / disable / delete

Disable — hides from active switch cards; cannot disable the current active endpoint
Delete — custom endpoints only; blocked if pending outbox items exist
Credential edits reset health to unknown

.env variables (initial seed)

STAGING_NELC_LRS_ENDPOINT=https://lrs.nelc.gov.sa/lrs-license-stg/xapi/statements
STAGING_NELC_LRS_USERNAME=elearn_oc_edu_sa
STAGING_NELC_LRS_PASSWORD=...

PRODUCTION_NELC_LRS_ENDPOINT=https://lrs.nelc.gov.sa/lrs-license/xapi/statements
PRODUCTION_NELC_LRS_USERNAME=
PRODUCTION_NELC_LRS_PASSWORD=