# Serenity with Cucumber

Last updated on : 09 Jan 2026

Overview

This guide covers the prerequisites and execution steps for running Serenity BDD tests on the Pcloudy platform.

## Prerequisites

Before you begin, ensure you have the following installed and configured:

1. Java Development Kit
- Version: Java 11 or higher
- Verification: Run java -version in terminal

2. Java Environment Variable
- Configure JAVA_HOME environment variable pointing to your JDK installation
- Add Java to your system PATH

3. Apache Maven
- Maven with JUnit framework support
- Verification: Run mvn -version in terminal

### Configuration

Step 1: Update Pcloudy Credentials

Navigate to pcloudySerenityDriver.java inside the test directory and replace the following values:
- clientName - Your Pcloudy client name
- apiKey - Your Pcloudy API key
- email - Your registered Pcloudy email
- baseUrl - Your Pcloudy instance URL

Step 2: Configure Test Environment
Open serenity.properties and update the following parameters:
- browserName - Browser to use (e.g., chrome, firefox, safari)
- browserVersion - Browser version (e.g., latest, 110, 109)
- os - Operating system (e.g., Windows, macOS, Linux)
- osVersion - OS version (e.g., 10, 11, Ventura)

### Execution

Run your Serenity tests using the following Maven commands:

Clean Project

```java
mvn clean
```

Execute Tests

Single Thread Execution:

```java
mvn verify -P single
```

Parallel Execution:

```java
mvn verify -P parallel
```