Starting a gateway instance - PingOne Cloud Platform - PingOne

PingOne Cloud Platform

bundle
pingone
ft:publication_title
PingOne Cloud Platform
Product_Version_ce
PingOne Cloud Platform
PingOne
category
Administratorguide
ContentType
Guide
Product
Productdocumentation
p1
p1cloudplatform
ContentType_ce
Product documentation
Guide > Administrator Guide
Guide

You can run the gateway in a Docker container or as a standalone Java application.

Note:

Stopping and starting a gateway instance does not cause any configuration issues, but the PingOne gateway will not function until the instance is started again.

You can also run an LDAP gateway as a standalone Windows service. For more information, see Running a standalone Gateway as a Windows service.

Starting the gateway instance in a Docker container

Use the Docker command that you copied from PingOne to start a Docker container. Run the Docker container on a computer that can reach your LDAP directory or RADIUS client, and PingOne.

  1. Ensure that Docker is installed and that the Docker Engine is running.
  2. Locate the Docker command that you copied earlier.

    For more information, see Adding an LDAP gateway or Adding a RADIUS gateway.

  3. Review the end user license agreement at www.pingidentity.com/en/legal/subscription-agreement.html.
  4. If you agree to the terms of the license agreement, open a text editor and modify the command as follows.

    Change -e PING_IDENTITY_ACCEPT_EULA=no to -e PING_IDENTITY_ACCEPT_EULA=yes.

  5. At a command prompt, run the command.

Verifying a gateway instance

Starting a gateway instance as a standalone Java application

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

For an LDAP gateway, ensure that you have Java 17 or Java 21 installed. For a RADIUS gateway, ensure that you have Java 8 or Java 11 installed.

Run the application on a computer that can reach your LDAP directory or RADIUS client, and PingOne.

  1. Go to Integrations > Gateways.
  2. Locate the appropriate gateway, and then click the gateway name to expand 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.
    Note:

    If prompted, complete the sign-on process.

    The download begins.
  6. To configure the gateway, extract the downloaded bundle and follow the instructions in the readme.txt file.

Verifying a gateway instance