Skip to main content

Enable

Enable a systemd service to start on boot. Returns changed: true if the service was not already enabled:

$ osapi client node service enable --target web-01 \
--name nginx.service

Job ID: 550e8400-e29b-41d4-a716-446655440000

NAME CHANGED
nginx.service true

If the service is already enabled, changed: false is returned:

$ osapi client node service enable --target web-01 \
--name nginx.service

Job ID: 550e8400-e29b-41d4-a716-446655440000

NAME CHANGED
nginx.service false

Broadcast enable to all hosts:

$ osapi client node service enable --target _all \
--name nginx.service

Job ID: 550e8400-e29b-41d4-a716-446655440000

HOSTNAME NAME CHANGED
web-01 nginx.service true
web-02 nginx.service true

JSON Output

Use --json to get the full API response:

$ osapi client node service enable --target web-01 \
--name nginx.service --json
{"results":[{"hostname":"web-01","name":"nginx.service","changed":true,"status":"ok"}],"job_id":"..."}

Flags

FlagDescriptionDefault
--nameService name to enablerequired
-T, --targetTarget: _any, _all, hostname, or label (group:web)_any
-j, --jsonOutput raw JSON response