---
title: Uninstalling the RHEL agent
description: Remove the PingAccess agent from a RHEL system. These steps apply to a PingAccess agent manually installed with an Apache Server, an Oracle HTTP Server, or an IBM HTTP Server.
component: pingaccess
version: 8.3
page_id: pingaccess:agents_and_integrations:pa_uninstalling_the_rhel_agent
canonical_url: https://docs.pingidentity.com/pingaccess/9.1/agents_and_integrations/pa_uninstalling_the_rhel_agent.html
llms_txt: https://docs.pingidentity.com/pingaccess/llms.txt
docs_for_agents: https://developer.pingidentity.com/build-with-ai/docs-for-agents.md
revdate: July 28, 2023
superseded_by: https://docs.pingidentity.com/pingaccess/9.1/agents_and_integrations/pa_uninstalling_the_rhel_agent.html
section_ids:
  about-this-task: About this task
  steps: Steps
  example: Example:
  example-2: Example:
  example-3: Example:
  example-4: Example:
  choose-from: Choose from:
---

# Uninstalling the RHEL agent

Remove the PingAccess agent from a RHEL system. These steps apply to a PingAccess agent manually installed with an Apache Server, an Oracle HTTP Server, or an IBM HTTP Server.

|   |                                                                                                                                                                    |
| - | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|   | If you installed the PingAccess agent using the standard installation process, uninstall it with the following command:```
sudo yum remove pingaccess-agent*.*
``` |

## About this task

|   |                                                                            |
| - | -------------------------------------------------------------------------- |
|   | *<$SERVER_HOME>* refers to the home install directory of your HTTP server. |

## Steps

1. Remove the `<$SERVER_HOME>/conf/agent.properties` file.

   ### Example:

   ```
   rm <$SERVER_HOME>/conf/agent.properties
   ```

2. Remove the following directive from the configuration file, `<$SERVER_HOME>/conf/httpd.conf`.

   ### Example:

   ```
   Include conf/10-paa.conf
   ```

3. Remove `10-paa.conf` from its installed location.

   ### Example:

   ```
   rm <$SERVER_HOME>/conf/10-paa.conf
   ```

4. Remove the `mod_paa.so` file from the `modules` directory.

   ### Example:

   ```
   rm <$SERVER_HOME>/modules/mod_paa.so
   ```

   |   |                                                                                                                     |
   | - | ------------------------------------------------------------------------------------------------------------------- |
   |   | To restore the server to its original state, you might also need to remove other modules installed as dependencies. |

5. Restart the service with one of the following commands:

   ### Choose from:

   * Apache: `systemctl restart httpd`

   * IBM HTTP Server: `apachectl restart`

   * Oracle HTTP Server: `<$ORACLE_HOME>/user_projects/domains/base_domain/bin/restartComponent.sh <$OHS_COMPONENT_NAME>`