Skip to main content
This is the command reference for running and operating the gateway using the command line. The CLI controls the running gateway over a local control API.

​
Example

moldable gateway status
This command asks the gateway for a status snapshot and prints it.

​
Global flags

  • --config <path>: override config file path.
  • --url <url>: override the gateway control URL (remote mode).
  • --token <token>: override auth token for remote control.

​
Commands

​
Run the gateway

moldable gateway run
If the startup security summary reports critical findings, the gateway will refuse to start. Use moldable gateway run --force to override (not recommended). Auto-restart on config changes is on by default. Set gateway.restart_on_change=false to disable, or use moldable gateway run --restart-on-change to force it on.

​
Health and status

moldable gateway health
moldable gateway status

​
Pairing

moldable gateway pair list
moldable gateway pair approve <channel> <code>
moldable gateway pair reject <channel> <code>

​
Node pairing and runtime

moldable gateway node pair-list
moldable gateway node pair-approve <node-id>
moldable gateway node pair-reject <node-id>
moldable gateway node runtime-list
moldable gateway node invoke <node-id> "<command>"

​
Channels and sessions

moldable gateway channels-status
moldable gateway sessions-list

​
Services

moldable gateway install-service
moldable gateway start-service
moldable gateway stop-service
moldable gateway restart-service
moldable gateway service-status

​
Onboarding

moldable onboard

​
Doctor

moldable doctor
moldable doctor --repair

​
Security audit (config + security checks)

moldable gateway audit
moldable gateway audit --fix
--fix applies safe config changes and tightens local file permissions (chmod).