@dirigiblelabs/dirigible

This package provides a direct distribution channel for the official Eclipse Dirigible standalone executable JAR file via the npm registry under the @dirigiblelabs organization scope.

It enables developers and CI/CD systems to retrieve Dirigible directly from npm,
while automatically downloading the correct JAR version during installation.

⚙️ How It Works

When you install the package, a small postinstall script runs automatically and:

1. Determines the package version (package.json → version).
2. Downloads the corresponding Dirigible executable JAR
3. Saves it as:

   @dirigiblelabs/dirigible/data/dirigible-application-executable.jar

4. Skips future downloads unless the npm package version changes.

🚀 Usage

Since Dirigible is a Java application, you must have the Java Development Kit (JDK) 21 or higher installed on your system to run the executable JAR. The default path of the jar is @dirigiblelabs/dirigible/data/dirigible-application-executable.jar

1. Installation

Install the package as a development dependency in your project:

npm install @dirigiblelabs/dirigible --save-dev

2. Execution

To run the Dirigible server, you need to execute the JAR file using the java -jar command.

The executable JAR file is installed in your node_modules folder. You can use a one-line command to locate and run it:

java -jar $(npm prefix)/node_modules/@dirigiblelabs/dirigible/data/dirigible-application-executable.jar

The server will start, typically accessible at http://localhost:8080. Default Login admin / admin

🔗 Project Resources

For comprehensive documentation, API references, and to learn more about the Eclipse Dirigible platform, please visit the official channels:

• Official GitHub Repository: https://github.com/eclipse-dirigible/dirigible
• Official Project Website: https://www.dirigible.io/