Skip to content

Environment variables ​

All configuration is read from the environment at start.

VariableDefaultMeaning
MOTIONCORE_ENGINE_ADDRLinux: unix:///run/motioncore/engine.sock; Windows/macOS: 127.0.0.1:7600Engine gRPC address: a gRPC target (unix:///path, dns:///host:port, …) or plain host:port (insecure, local only)
MOTIONCORE_API_ADDR127.0.0.1:8080HTTP listen address
MOTIONCORE_API_TOKEN–admin token: full access, including firmware flashing
MOTIONCORE_OPERATOR_TOKEN–operator token: motion and drive commands, firmware builds
MOTIONCORE_VIEWER_TOKEN–viewer token: read-only plus stop / estop
MOTIONCORE_ALLOWED_ORIGINSlocalhost:5173,127.0.0.1:5173Extra browser origins (host patterns) allowed for the WebSocket and POSTs. Same-origin is always allowed
MOTIONCORE_ALLOWED_HOSTS–Extra Host patterns accepted while authentication is off (e.g. robot.lan:* behind a local proxy)
MOTIONCORE_AUDIT_LOG– (main log)File for JSON-lines audit records
MOTIONCORE_RATE_LIMIT20POST requests per second per client IP; stop and estop are never limited
MOTIONCORE_RATE_BURST40Burst for the above
MOTIONCORE_WEB_DIR–Built web UI to serve at /, with SPA fallback and security headers

If no token is set, authentication is off and ratavyr refuses to start on a non-loopback address. Tokens must differ from each other; tokens shorter than 16 characters are accepted with a warning.

Development and tests ​

VariableUsed byMeaning
MOTIONCORE_REPOscripts/generate.sh, integration testsPath to a motioncore checkout (default ../motioncore)
MOTIONCORE_BINintegration testsPath to the motioncore binary

Part of MotionCore. A software stop never replaces a hardware E-stop circuit.