Installing Rule Designer offline

You download Rule Designer from a GitHub resource and install it into Eclipse.

Before you begin

You must have installed the compatible versions of Eclipse and Java JDK (see Software requirements). To view this documentation offline, see Offline and mobile access.

About this task

In this task, you download the source code for Rule Designer and install it in an existing instance of Eclipse.

Procedure

  1. Go to the Rule Designer releases External link opens a new window or tab.
  2. Download the source code, and decompress it on your local machine.
  3. Start Eclipse.
  4. Click Window > Open Perspective > Java to use the Java™ perspective.
  5. Open the available software sites for your operating system.
    • Windows and Linux: Click Window > Preferences > Install > Update > Available software sites.
    • macOS: Click Eclipse > Settings > Install/Update > Available software sites.
  6. Disable all the sites except the following:
    • https://download.eclipse.org/releases/2025-12/
    • https://download.eclipse.org/eclipse/updates/4.38/
  7. Click Apply > Close.
  8. Click Help > Install New Software.
  9. Add the update site to install:
    1. In the Install wizard, next to the Work with field, click Add.
    2. In the Name field, enter a name for the repository, for example, enter Rule Designer.
    3. Click Local, and select the p2 folder in the decompressed directory.
  10. Click Select All > Next. Eclipse determines the dependencies and requirements.
  11. In the Install dialog, click Next.
  12. In the Review Licenses dialog, select the following statement: 
    I accept the terms of the license agreement
  13. Click Finish to start the installation. If a security warning about the validity of the software opens, click OK to proceed with the installation.
  14. During the installation, you are prompted with a Trusted Authorities dialog. Select https://raw.githubusercontent.com in Authoring / Update site section and then click Trust Selected to continue.
  15. A Trust Artifacts dialog opens a few moments later. Click Select All, and then click Trust Selected to continue the installation. The installation might take a few seconds to complete.
  16. If you are prompted to restart Eclipse, click Yes.
  17. Click Window > Open Perspective > Rule to use the Rule perspective.

What to do next

If you want to establish a secure TLS connection or/and use an OpenID provider with ODM on Kubernetes, you need to import a certificate into the cacerts file and configure the OpenID provider in the JVM used to launch Rule Designer (see Importing a security certificate in Rule Designer).