Skip to main content
This guide provides step-by-step instructions for setting up your development environment for Aletyx Enterprise Build of Kogito and Drools on Ubuntu®. The setup includes Docker, Java 17, Apache Maven, and Visual Studio Code®.

Docker Installation

1. Remove Potentially Conflicting Packages

First, remove any old or conflicting Docker installations to ensure a clean setup:

2. Install Prerequisites

Install necessary packages to allow apt to use repositories over HTTPS:

3. Set Up Docker Repository

Add Docker’s official GPG key to ensure package authenticity:
Add the stable Docker repository to APT sources:

4. Install Docker Engine

Update package index and install the latest version of Docker Engine and containerd:

5. Configure Docker User Permissions

Add your user to the docker group to run Docker commands without sudo:

6. Configure Docker Service

Start and enable the Docker service to run on system startup:

Docker Compose Installation

1. Install Docker Compose

Download and install the latest stable version of Docker Compose:
Make the binary executable:
Verify the installation:

Visual Studio Code Installation

Install Visual Studio Code, a powerful IDE with excellent Docker and Java support. This benefit is only grown more within the Apache KIE Community with provided plugins to add to the power of the tool!

Java Development Environment

1. Install OpenJDK 17

Install the Java Development Kit - JDK 17:

2. Install and Configure Maven

Download and install Apache Maven 3.9.6:
Extract Maven to the /opt directory:
Create a symbolic link for easier version management:
Confirm the Java that you’re using with:
Make sure you understand which version of Java you’re using, if you’re using an arm64 deployment of Ubuntu, then you will probably have /usr/lib/jvm/java-17-openjdk-arm64/bin/java instead of -amd64 as seen in the message above.
Configure environment variables for Java and Maven in your ~/.bashrc:
Load the new environment variables:
Verify Maven installation:

Next Steps

After completing this setup:
  1. Log out and log back in for group changes to take effect
  2. Test Docker installation by running: docker run hello-world
  3. Install recommended VS Code extensions for Java and Docker development
  4. Configure Maven settings if working with private repositories

Troubleshooting Tips

  • If Docker commands fail, ensure your user is properly added to the docker group
  • If Maven isn’t recognized, verify the environment variables are properly set
  • For VS Code extensions, ensure Java Extension Pack is installed for full Java support