---
title: Configuring PingCentral to run as a Linux systemv service
description: Run PingCentral as a Linux systemv service that automatically starts when Linux starts.
component: pingcentral
version: 2.2
page_id: pingcentral:pingcentral_for_iam_administrators:pingcentral_conf_pc_linux_systemv
canonical_url: https://docs.pingidentity.com/pingcentral/2.2/pingcentral_for_iam_administrators/pingcentral_conf_pc_linux_systemv.html
revdate: May 3, 2024
section_ids:
  before-you-begin: Before you begin
  steps: Steps
---

# Configuring PingCentral to run as a Linux systemv service

Run PingCentral as a Linux systemv service that automatically starts when Linux starts.

## Before you begin

Ensure that:

* You are signed on to your system as a root user.

* The *\<JAVA\_HOME>*`JAVA_HOME` path points to the Java Development Kit (JDK) software on your system. For example, `/usr/lib/jvm/java-11-openjdk-11.0.5.10-0.e17_7.x86_64`. To verify this information, run the `echo $JAVA_HOME` command.

* The `PINGCENTRAL_HOME` path points to the folder extracted from the `.zip` archive in your installation directory. Ensure that this path doesn't reside within a user's home folder.

## Steps

1. Copy the `pingcentral` file from `<PINGCENTRAL_HOME>/sbin/linux/pingcentral` to `/etc/init.d`.

2. Create a new user to run PingCentral. You might want to create a new user account for each service you run as a way of keeping your services separate, or associate the account with a running process.

3. Create a new `pingcentral` folder in `/var/run/pingcentral` and ensure that the user who will run the service has read and write permissions to the folder.

4. Access the `pingcentral` file in the `/etc/init.d` folder and set values for the following variables at the beginning of the script:

   * `export <JAVA-HOME>`: Specify the name and location of the Java installation folder.

   * `export <PINGCENTRAL_HOME>`: Specify the name and location of the PingCentral installation folder.

   * (Optional): `export USER`: Specify the name of the user who will run the service, if applicable.

5. Register the service by running the `chkconfig --add pingcentral` command from the `/etc/init.d` folder.

6. Make the service script executable by running the `chmod +x pingcentral` command.

   After registering the service, you can control it by running the `pingcentral` command from the `/etc/init.d` folder with the following options:

   * `start`: Starts the PingCentral service.

   * `stop`: Stops the PingCentral service.

   * `restart`: Restarts the PingCentral service.

   * `status`: Displays the status of the PingCentral service and the service process ID.