System Status

Commands

Run maintenance commands — version, licenses, system ID, software restart, license upload — on any Device this C21 Live Control instance manages.

What it does

System status → Commands runs maintenance commands against any system this C21 Live Control instance manages — the Control host itself or any registered C21 Live Encoder. You pick the target Device and the command, run it, and read the result inline.

Some commands touch the running system, so the view warns up front — "Here you can execute commands on any system controlled by this instance of C21 Live Control. These commands include rebooting and shutting down systems, so please be careful." — and asks for confirmation before the destructive ones.

UI Interface

ControlPurpose
DeviceTarget system. The picker includes this Live Control instance plus every registered Encoder.
CommandThe command to run (see the catalogue below).
Execute commandRuns the selected command on the selected Device.
Command outputThe result of the command is shown inline once it returns.

Destructive commands open a Confirm action dialog before running. Upload license additionally prompts for the license file to send.

Command catalogue

CommandWhat it does
Show versionReturns the software name, version and release of the target.
Show licensesLists the license slots installed on the target.
Show system IDReturns the host fingerprint used to request a license.
Software restartRestarts the target's software stack. Asks for confirmation first.
Upload licenseSends a license file to the target and installs it.

The catalogue adapts to the selected Device; a given target only offers the commands that apply to it.

The database backup is not a command: it is kept on the Control host, where the administrator makes, schedules and restores it with the livecontrol CLI. See Backups.

API surface

Every command dispatches to a single endpoint. The action field selects the operation and ip selects the target Device (the Control answers on 127.0.0.1; an Encoder on its LAN address).

CommandRequest
Show versionPOST /c21apiv2/system/command — { "action": "getVersion", "ip": "<device-ip>" }
Show licensesPOST /c21apiv2/system/command — { "action": "getLicenses", "ip": "<device-ip>" }
Show system IDPOST /c21apiv2/system/command — { "action": "getSystemId", "ip": "<device-ip>" }
Software restartPOST /c21apiv2/system/command — { "action": "restartSoftware", "ip": "<device-ip>" }

The Device picker is populated by GET /c21apiv2/devices?includeControl=1 — the includeControl flag adds this Live Control instance to the list of registered Encoders.

  • Logs — read the log tail of the same Devices.
  • Devices — register the Encoders that appear in the Device picker.
  • Licenses — the slots that Show licenses reports and Upload license installs.
  • Install C21 Live Control — the livecontrol CLI equivalents (version, license, restart) on the host, and the host-only backup / restore.

FAQ

Copyright © 2026