The service utility is used to manage services on the Plesk server through CLI. By using this utility, you can perform the following tasks:

  • displaying a list of available services
  • starting, stopping, or restarting a service
  • querying the current running status of a service
  • specifying the information to be included in the list of available services and format its display parameters

Usage

service <command> [
<option_1> [<param>]
[<option_2> [<param>]]
... [<option_N> [<param>]]
]

Example

The following command displays detailed information about the dns and mail services as a table:

plesk bin service --list -include dns,mail -format "\n\t%k,\t%N,\t%S\t%I\t%p\n"

Commands

Command Parameter Description Example
--start or -s
<service_
name>
Starts a service.

To start the DNS service:

plesk bin service --start dns

or

plesk bin service -s dns

--stop or -p
<service_
name>
Stops a service.

To stop the DNS service:

plesk bin service --stop dns

or

plesk bin service -p dns

--restart or -r
<service_
name>
Restarts a service.

To restart the DNS service:

plesk bin service --restart dns

or

plesk bin service -r dns

--status or -t
<service_
name>
Displays the current status of a service.

To view the current status of the DNS service:

plesk bin service --status dns

or

plesk bin service -t dns

--list or -l  

Displays information about available services.

Can be used with the -detail and -format options to display detailed information about services.

To view the list of available services:

plesk bin service --list

or

plesk bin service -l

--help or -h   Displays help on the use of the utility.

To view help on the use of the utility:

plesk bin service --help

or

plesk bin service -h

Options

Option Parameter Description Example
-include <service_name_1>[,<service_keyname_2>,... <service_name_N>] Specifies the list of services to be included in the --list command output.

To view detailed information about DNS and Mail services only:

plesk bin service -l -include dns,mail -detail

-exclude <service_name_1>[,<service_keyname_2>,... <service_name_N>] Specifies the list of services to be excluded from the --list command output.

To view detailed information about all services excluding DNS and Mail services:

plesk bin service -l -exclude dns,mail -detail

-detail   Set the detailed format for the --list command output (equivalent to -format "%k\t%N\t%S\t%I\t%p\n").  
-format

"%<output_parameter_1>[,%<output_parameter_2>,...,%<output_parameter_N>"

use \n, \t, or a comma to format the output display as needed.

Specifies the information to be included in the detailed output and the display parameters of the --list command.

  • %k - service key
  • %N - service name
  • %s - service status code
  • %S - service status
  • %i - available code
  • %I - information about available code
  • %p - package name
  • %% - %
  • \n - new line
  • \t - tab

Is set to "%k" by default.

To view detailed information about DNS and Mail services as a table:

plesk bin service -l -include dns,mail -format "\n\t%k,\t%N,\t%S\t%I\t%p\n"