barry service

See and control this instance’s services.

barry service [options] [command]

Subcommand	Description
status	Show services (all, or the named ones or bags): state, port, health. Non-zero when one needs attention.
list	List declared services and their management state.
add	Register a service (disabled unless already enabled); does not start it.
remove	Unregister a service and remember the removal; stops it but keeps its software and data.
enable	Enable a service’s launch at next login/boot; does not start it unless –now.
disable	Disable a service’s launch at next login/boot; keeps it running unless –now.
run	Run one prepared service in the foreground.
url	Print where a service listens, for scripts.
start	Start named services or bags; all starts enabled, registered user services that are not running.
stop	Stop named services or bags; all stops running, enabled user services.
restart	Restart named services or bags; all restarts running, enabled user services except apps.
logs	Show a service’s logs.
port	Move a service to another port, and wait until every route that targets it follows.

barry service status

Show services (all, or the named ones or bags): state, port, health. Non-zero when one needs attention.

barry service status [options] [services...]

Argument	Required
services...	Optional

Option	Description
--json	Print service management status as JSON, for scripts.

barry service list

List declared services and their management state.

barry service list [options]

Option	Description
--json

barry service add

Register a service (disabled unless already enabled); does not start it.

barry service add [options] <service>

Argument	Required
service	Required

Option	Description
--now	Also start or stop now.

barry service remove

Unregister a service and remember the removal; stops it but keeps its software and data.

barry service remove [options] <service>

Argument	Required
service	Required

Option	Description
--now	Also start or stop now.

barry service enable

Enable a service’s launch at next login/boot; does not start it unless –now.

barry service enable [options] <service>

Argument	Required
service	Required

Option	Description
--now	Also start or stop now.

barry service disable

Disable a service’s launch at next login/boot; keeps it running unless –now.

barry service disable [options] <service>

Argument	Required
service	Required

Option	Description
--now	Also start or stop now.

barry service run

Run one prepared service in the foreground.

barry service run [options] <service>

Argument	Required
service	Required

barry service url

Print where a service listens, for scripts.

barry service url [options] <service>

Argument	Required
service	Required

barry service start

Start named services or bags; all starts enabled, registered user services that are not running.

barry service start [options] [services...]

Argument	Required
services...	Optional

barry service stop

Stop named services or bags; all stops running, enabled user services.

barry service stop [options] [services...]

Argument	Required
services...	Optional

barry service restart

Restart named services or bags; all restarts running, enabled user services except apps.

barry service restart [options] [services...]

Argument	Required
services...	Optional

Option	Description
--dry-run	Print what would restart, without restarting.

barry service logs

Show a service’s logs.

barry service logs [options] [service]

Argument	Required
service	Optional

Option	Description
-f, --follow	Follow logs in real time.
-n, --lines <number>	Number of lines to show. Default 50.
--stderr	Show stderr instead of stdout.
--rotate	Rotate a stopped service log, retaining three archives.

barry service port

Move a service to another port, and wait until every route that targets it follows.

barry service port [options] <service> <port>

Argument	Required
service	Required
port	Required

Every command also accepts -h, --help. All system commands.