---
title: Starting a gateway instance as a standalone Java application
description: Download a gateway bundle and run it on a local computer as a Java application.
component: pingone
page_id: pingone:integrations:p1_starting_gateway_instance_java_ldap
canonical_url: https://docs.pingidentity.com/pingone/integrations/p1_starting_gateway_instance_java_ldap.html
revdate: August 22, 2024
section_ids:
  before-you-begin: Before you begin
  about-this-task: About this task
  steps: Steps
  result: Result:
  next-steps: Next steps
---

# Starting a gateway instance as a standalone Java application

Download a gateway bundle and run it on a local computer as a Java application.

## Before you begin

* If you have a valid gateway credential, have it ready. Alternatively, you can create a new credential on the **Overview** tab in the gateway details. Learn more in [Creating or revoking a gateway credential](p1_creating_deleting_gateway_credential_ldap.html).

* Install Java 21 LTS on the computer that will run the gateway.

* Create a `JAVA_HOME` system environment variable that points to the directory that contains the bin directory from the Java distribution.

## About this task

Run the application on a computer that can reach your LDAP directory and PingOne.

## Steps

1. Go to **Integrations → Gateways** and locate the appropriate gateway.

2. Click the gateway name to expand the gateway details.

3. Click the **Download** tab.

4. In the **Standalone** section, review the prerequisites and instructions.

5. In the **Instructions** section, click the download link for the gateway bundle.

   |   |                                               |
   | - | --------------------------------------------- |
   |   | **If promted, complete the sign-on process.** |

   ### Result:

   The download begins

6. Follow the instructions in the `README.txt` file to configure the `run.properties` file, including providing the gateway credential information.

7. Optional: To configure an LDAP Gateway client application to use a forward web proxy server to handle traffic between the gateway and PingOne, provide access information into the `run.properties` file.

   |   |                                                                                                                                                                                                                                                                                                                                                                                     |
   | - | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   |   | * You must configure the web proxy settings locally per each running instance. For example, if you're running two gateway client applications, you must configure web proxy settings in both instances.

   * Digest authentication does not support international characters.

   * Basic authentication requires configuration in the proxy server to support international characters. |

8. Sign on to the computer with administrator privileges.

9. At a command prompt, run the `bin\run.bat` file for Windows or the `bin/run.sh` file for Linux.

## Next steps

[Verify a gateway instance](p1_verifying_gateway_instance_ldap.html)