Page tree
Skip to end of metadata
Go to start of metadata


Ninja is a comprehensive DevOps toolchain for Pega platform.

The best way to get started with Ninja is to try it in the cloud for free – read this article for step by step instructions.


Ninja is a toolchain for Pega platform, so you'll need an instance of Pega platform to try Ninja. Ninja is compatible with Pega platform versions starting with 7.1.8 and up to 7.4.0.

Installation process of Ninja trial is optimized for Pega Personal Edition.

Request Ninja trial in the cloud

To request your trial instance of Ninja in a cloud, please fill this form. Once your request is processed, you'll receive an email with connection details.

Install and configure Ninja

  1. Start your Pega PE and wait until it becomes available.
  2. Download and unzip Ninja Demo bundle.
  3. Launch deploy.bat script.
  4. Enter pe when installation prompts. 

    [2018-12-05 09:34:37.948] INFO  .goblin.deploy.core.ExecutionServiceImpl Deployment started
    Choose env [pe, unknown]: pe
  5. Enter your Ninja trial instance URL when installation prompts. 

    [2018-12-05 09:36:45.730] INFO  .goblin.deploy.core.ExecutionServiceImpl Processing chunk pega-archive 1/1 (3/9): dev-config for pega-ninja (chunks/pega-archive/dev-config-2.1.16.RELEASE.jar)
    Enter property 'ninja.url': http://XXX.XXX.XXX.XXX:8080/ninja-webapp/api/rest/
  6. Wait until installation successfully completes. 

    [2018-12-05 09:37:31.965] INFO  .goblin.deploy.core.ExecutionServiceImpl Deployment finished (success)
    [2018-12-05 09:37:32.020] INFO Logging out admin@ninja from http://localhost:8080/prweb/PRServlet
  7. Restart Pega PE and restart it.
  8. Login to Pega PE under NinjaDeveloper (password: rules).

If you are using Pega instance other then PE you have two options:

  1. Update file config/ and provide appropriate parameters.
  2. Or select unknown environment and provide required parameters as installation prompts.

Explore Ninja Unit Testing

Once Ninja is configure, you may start exploring Ninja features, Unit Testing is a good one to start with.

For more details please refer to this article.

  • No labels