---
title: Using the sample application
description: ForgeRock provides a mockup web application for testing IG configurations. The sample application is used in the examples in this guide and the Gateway guide.
component: pinggateway
version: 7.2
page_id: pinggateway:getting-started:start-sampleapp
canonical_url: https://docs.pingidentity.com/pinggateway/2026/getting-started/start-sampleapp.html
llms_txt: https://docs.pingidentity.com/pinggateway/llms.txt
docs_for_agents: https://developer.pingidentity.com/build-with-ai/docs-for-agents.md
revdate: 2022-04-20T15:23:46Z
superseded_by: https://docs.pingidentity.com/pinggateway/2026/getting-started/start-sampleapp.html
section_ids:
  start-sampleapp-download: Downloading the sample application
  start-sampleapp-start: Starting the sample application
  start-sampleapp-stop: Stopping the sample application
  start-sampleapp-static: Serving static resources for the sample application
  start-sampleapp-conf: Configuration options for the sample application
---

# Using the sample application

ForgeRock provides a mockup web application for testing IG configurations. The sample application is used in the examples in this guide and the *Gateway guide*.

## Downloading the sample application

1. Download `IG-sample-application-7.2.0-jar-with-dependencies.jar`, from the [Ping Identity Product Downloads](https://product-downloads.pingidentity.com/).

## Starting the sample application

1. Start the sample application:

   ```bash
   $ java -jar IG-sample-application-7.2.0-jar-with-dependencies.jar

   [...] [INFO   ] All 8 verticles started on ports : [8081, 8444]
   [...] [INFO   ] Using session timeout of: 60s
   [...] [INFO   ] Using AM base for OpenID Discovery URL: http://am.example.com:8088/openam/oauth2
   [...] [INFO   ] Press Ctrl+C to stop the server.
   ```

   By default this server listens for HTTP on port 8081, and for HTTPS on port 8444. If one or both of those ports are not free, specify other ports:

   ```bash
   $ java -jar IG-sample-application-7.2.0-jar-with-dependencies.jar 8888 8889
   ```

2. Check that the sample application is running in one of the following ways:

   1. Go to <http://localhost:8081/home> to access the home page of the sample application. Information about the browser request is displayed.

   2. Go to <http://localhost:8081/login> to access the login page of the sample application, and then log in with username `demo` and password `Ch4ng31t`. The username and some information about the browser request is displayed.

## Stopping the sample application

1. In the terminal where the sample application is running, select CTRL+C to stop the app.

## Serving static resources for the sample application

When the sample application is used with IG in the examples in this guide and the *Gateway guide*, the sample application must serve static resources, such as the .css. Add the following route to the IG configuration, as:

* Linux

* Windows

```
$HOME/.openig/config/routes/static-resources.json
```

```
%appdata%\OpenIG\config\routes\static-resources.json
```

```json
{
  "name" : "sampleapp-resources",
  "baseURI" : "http://app.example.com:8081",
  "condition": "${find(request.uri.path,'^/css')}",
  "handler": "ReverseProxyHandler"
}
```

## Configuration options for the sample application

To view the command-line options for the sample application, start it with the `-h` option:

```bash
$ java -jar IG-sample-application-7.2.0-jar-with-dependencies.jar -h

Usage: <main class> [options]
Options:
--http
The HTTP port number.
Default: 8081
--https
The HTTPS port number.
Default: 8444
--session
The session timeout in seconds.
Default: 60
--am-discovery-url
The AM URL base for OpenID Provider Configuration.
Default: http://am.example.com:8088/openam/oauth2
-h, --help
Default: false
```