--- title: Installing on RHEL 10 description: Install a PingAccess agent on a RHEL 10 system with Apache 2.4, either conventionally or manually. component: pingaccess version: 9.1 page_id: pingaccess:agents_and_integrations:pa_r10_installation canonical_url: https://docs.pingidentity.com/pingaccess/9.1/agents_and_integrations/pa_r10_installation.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 24, 2026 section_ids: before-you-begin: Before you begin installing-rhel10: Installing on RHEL 10 conventionally before-you-begin-2: Before you begin steps: Steps manually-installing-rhel10: Manually Installing on RHEL 10 about-this-task: About this task steps-2: Steps --- # Installing on RHEL 10 Install a PingAccess agent on a RHEL 10 system with Apache 2.4, either conventionally or manually. | | | | - | ---------------------------------------------------------------------------------------------------------------------------------------- | | | The agent supports both x86\_64 and ARM64 architectures. In the installation steps, replace *\* with either `x86_64` or `aarch64`. | ## Before you begin If you haven't downloaded an `agent.properties` file, you must first: 1. In the PingAccess console, go to **Applications > Agents**. 2. Click the **Pencil** icon to edit a configured agent. If you haven't created an agent yet, refer to [Agents](../pingaccess_user_interface_reference_guide/pa_agents.html). 3. In the **Shared Secrets** section, click the **Download** icon to download the configuration. | | | | - | --------------------------------------------------------------------- | | | The name of the configuration file is `_agent.properties`. | * Installing on RHEL 10 * Manually Installing on RHEL 10 ## Installing on RHEL 10 conventionally ### Before you begin Download and extract the `pingaccess-agent-apache24-rhel10-.zip` archive. | | | | - | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | The Agent RPM has required dependencies that might be available through standard repositories. If these dependencies aren't available in your Linux version, you can install them using the included packages:- `openpgm-5.2.122-36.el10_0..rpm` - `libsodium-1.0.22-1.el10_2..rpm` - `libunwind-1.8.0-4.el10_0..rpm` - `zeromq-4.3.5-18.el10_0..rpm`You can install these RPMs using `dnf install libsodium*rpm openpgm*rpm libunwind*rpm zeromq*rpm`. | ### Steps 1. In RHEL, change to the `pingaccess-agent-apache24-rhel10-/` directory. 2. As root, install the PingAccess Agent for Apache using the following command: ``` dnf install pingaccess-agent-apache-*.rpm ``` | | | | - | ---------------------------------------------------------------------------------------------------------------------------------------------- | | | You might need to first run the `dnf update libsepol checkpolicy selinux-policy` command to avoid any errors if your tools are not up to date. | 3. Copy the `_agent.properties` file to `/etc/httpd/conf.d/agent.properties`. 4. As root, restart the Apache service using the following command: ``` systemctl restart httpd ``` ## Manually Installing on RHEL 10 ### About this task This procedure assumes that: * A non-root user is installing the PingAccess Agent for Apache in a custom Apache instance. * You've installed the Apache installation at `$APACHE`. If you haven't, modify the file paths specified in this procedure based on where your Apache installation and configuration files are located. ### Steps 1. Install the following required dependencies from the Red Hat official repositories: ``` libcurl. pcre2. ``` 2. Copy the RPMs from the `.zip` distribution into a directory called `pkgroot` and unpack them using the following commands: ``` mkdir pkgroot cp *.rpm pkgroot/ cd pkgroot for r in *.rpm; do rpm2cpio $r | cpio -idmv; done ``` 3. Copy the extracted files to the appropriate places with the following commands: ``` cp etc/httpd/conf.modules.d/10-paa.conf $APACHE/conf cp -av usr/lib64/*.so* $APACHE/modules cp usr/lib64/httpd/modules/*.so $APACHE/modules ``` 4. Add the following directive to the Apache configuration file (`$APACHE/conf/httpd.conf`) to include the PingAccess Agent for Apache module configuration: ``` Include conf/10-paa.conf ``` 5. Edit the `10-paa.conf` file and make the following changes: 1. Add the following lines before the `LoadModule` directive: ``` LoadFile modules/libunwind.so.8 LoadFile modules/libpgm-5.2.so.0 LoadFile modules/libsodium.so.26 LoadFile modules/libzmq.so.5 ``` 2. Change all instances of `conf.d` to `conf`. 6. Copy your downloaded `_agent.properties` to `$APACHE/conf/agent.properties`. 7. As root, restart the Apache service using the following command: ``` systemctl restart httpd ```