---
title: Supported Framework Versions & Execution Stacks
slug: suite-documentation/supported-framework-versions-and-execution-stacks
docTags: 
createdAt: 2026-04-16T10:03:12.934Z
---

## Overview

Testinium SUITE executes your test code within a **predefined and controlled cloud environment**.

Because the execution layer is fully managed:

- Your test code must align with our supported framework versions 
- Arbitrary version combinations are **not supported** 
- Only predefined **execution stacks** are guaranteed to work 

:::hint{type="success"}
*If you use the supported combinations below, your tests will run without compatibility issues.*
:::

## Supported Execution Stacks

We support **strictly defined version combinations**.

Your project must match the required mapping between frameworks and runtime.

:::hint{type="info"}
**Compatibility Note:**

- **Selenium 4, and Appium 2 projects** → requires **Java 21**
- **Selenium 3, Appium 1, and API (Service) projects** → require **Java 23**

Minor version differences may still work if they are compatible with the versions listed below.
For example, **Selenium 4.35** is generally compatible with **Selenium 4.19.1**.

Java versions are generally backward compatible, meaning code written for older Java versions may run on newer ones.
However, in this environment, **framework and Java combinations are strictly enforced**, so you should follow the required mapping.
:::

### Stack 1

For Selenium 4 and Appium 2 projects

| Component     | Version                                      |
| ------------- | -------------------------------------------- |
| Java          | 21                                           |
| Selenium 4    | 4.19.1                                       |
| Appium 2      | 2.5.4                                        |
| Maven         | Latest                                       |
| Gauge Plugins | Latest (HTML Report, XML Report, Screenshot) |

### Stack 2

For Selenium 3, Appium 1, and API (Service) projects

| Component     | Version                                      |
| ------------- | -------------------------------------------- |
| Java          | 23                                           |
| Selenium 3    | 3.141.59                                     |
| Appium 1      | 1.21.0                                       |
| API Testing   | Supported                                    |
| Maven         | Latest                                       |
| Gauge Plugins | Latest (HTML Report, XML Report, Screenshot) |

## Important Rules

### 1. Follow the Required Mapping

Framework and Java versions are **strictly coupled**.

Examples (NOT supported):

- Selenium 4 + Java 23 ❌ 
- Appium 2 + Java 23 ❌ 
- Selenium 3 + Java 21 ❌ 

### 2. Framework Versions Are Controlled

Even if newer versions exist:

- They are **not automatically supported** 
- Compatibility is only guaranteed within the defined stacks 

### 3. Execution Model Constraint

Testinium SUITE:

- Builds your project 
- Executes your tests 
- Manages the runtime environment 

Because of this:

- Version flexibility is intentionally limited 
- Stability and predictability are prioritized 

## What This Means for You

- If your project matches the required combination → ✔ No compatibility issues expected 
- If not → ⚠ Your project must be adjusted before execution 

## Recommendation

- New automation projects → use **Selenium 4 + Appium 2 with Java 21** 
- Existing or service-based projects → use **Java 23 stack**