Skip to content

CLI Machines Power Services Restart

github-actions[bot] edited this page Aug 17, 2026 · 3 revisions

ed machines services restart

Restarts one unit.

ed machines services restart <machine> <unit> [--json]

Arguments

Name Type / values Default What it does
<machine> machine name, ssh alias or id required Which machine the unit lives on.
<unit> unit name required The unit, for example nginx.service.

Options

Name Type / values Default What it does
--json flag off Emit JSON on stdout instead of the human line.
--help, -h flag off Print the help for this command on stdout and exit 0.
$ ed machines services restart tuf nginx.service
restarted nginx.service on Asus TUF 7

--json shape

{
  "action": "restart",
  "applied": true,
  "machine": "Asus TUF 7",
  "unit": "nginx.service"
}

Examples

ed machines services restart tuf nginx.service
ed machines tuf services restart docker.service
ed machines services restart tuf nginx.service --json

Behaviour notes

systemctl restart on a stopped unit starts it, so this is the verb to reach for when you do not care what state the unit was in. The 60 second timeout is the one to watch: a unit with a slow ExecStop can outlast it, and the command then reports a failure for something that finishes fine a moment later.

Only start, stop and restart exist. There is no enable, disable, reload, status or journal verb; for those, use the raw form, ed tuf systemctl reload nginx or ed tuf journalctl -u nginx -n 100.

Where to go next

CLI reference

Getting Started
Config
App
Extensions
Permissions
Usage
System
Music
Calendar
Clipboard
Color
Download
Apps
Tools
Shelf
Cleaner
Machines
Machines Remote
Machines Docker
Machines Files
Machines Power
Machines Workspace
Companion
Herdr
Lid Awake
Machines Thermal

Guides

Clone this wiki locally