Documentation

PLEASE NOTE: This document applies to v2.18 version and not to the latest stable release v2.19

Documentation for other releases can be found by using the version selector in the top right of any doc page.

service

Manage services on target hosts. This module is a wrapper for service management on different init systems (systemd, sysvinit, openrc).

Attributes

check_mode:
  support: full

Parameters

Parameter	Required	Type	Values	Description
enabled		boolean		Whether the service should be enabled, disabled, or neither.
name	true	string		Name of the service to manage.
state		string	reloaded restarted started stopped	State of the service.
use		string	systemd openrc sysvinit	The service manager to use. If not specified, it will be auto-detected.

Example

- name: Start service httpd
  service:
    name: httpd
    state: started

- name: Stop service httpd
  service:
    name: httpd
    state: stopped

- name: Restart service httpd
  service:
    name: httpd
    state: restarted

- name: Reload service httpd
  service:
    name: httpd
    state: reloaded

- name: Enable service httpd and ensure it is started
  service:
    name: httpd
    enabled: true
    state: started

- name: Enable service httpd on boot
  service:
    name: httpd
    enabled: true