•  
    •  
  • website icon
Get started
Healenium Pro - Installation Guide

Healenium Pro — Installation Guide

Prerequisites

Before you begin, ensure you have:

  • Docker (20.10+) and Docker Compose (2.0+) — for Docker installation
  • Java 11+ — for Shell installation
  • Python 3.8+ — for Shell installation
  • PostgreSQL 15+ — for Shell installation only
  • GitHub Token (provided via email after purchase)
  • Docker Hub credentials (provided via email after purchase)
  • Minimum 4GB RAM and 10GB disk space

Choose Installation Method

Choose one of four options. Each includes the common setup steps (credentials, clone, .env) and then the steps specific to that method.

  • Docker + Selenium — All services in containers
  • Docker + Playwright — All services in containers
  • Shell + Selenium — Manual setup with scripts
  • Shell + Playwright — Manual setup with scripts
Docker + Selenium

Step 1: Receive Access Credentials

After purchasing Healenium Pro, you will receive an email with: GitHub Token, Docker Hub username, Docker Hub password, License information.

Important: Keep these credentials secure. You'll need them to download Pro components.

Step 2: Download Configuration Files

Clone the Healenium Pro configuration:

Clone repository 
git clone https://github.com/healenium/healenium.git
cd healenium/pro

Step 3: Configure Credentials

Create and configure the .env file with credentials from your email:

Create .env file 
cp .env.example .env
nano .env

Add your credentials to .env:

.env contents 
# GitHub token (required for Shell installation)
GITHUB_TOKEN=your_github_token_here

# Docker Hub credentials (required for Docker installation)
DOCKER_USERNAME=your_docker_username
DOCKER_TOKEN=your_docker_password

Step 4: Login to Docker Registry

Run the login script to authenticate with Docker Hub:

Login to Docker Registry 
chmod +x docker_login.sh
./docker_login.sh

This script will read credentials from .env and login to Docker Hub.

Step 5: Start Services

Start Healenium Pro with Selenium 
docker compose -f docker-compose-pro-selenium.yaml up -d

This will start: PostgreSQL, Healenium Backend, Proxy, Selector Imitator, AI Service, UI Dashboard, Selenium Grid (Hub + Chrome/Firefox/Edge nodes).

Step 6: Verify

Check Docker services 
docker compose ps
Docker + Playwright

Step 1: Receive Access Credentials

After purchasing Healenium Pro, you will receive an email with: GitHub Token, Docker Hub username, Docker Hub password, License information.

Important: Keep these credentials secure. You'll need them to download Pro components.

Step 2: Download Configuration Files

Clone the Healenium Pro configuration:

Clone repository 
git clone https://github.com/healenium/healenium.git
cd healenium/pro

Step 3: Configure Credentials

Create and configure the .env file with credentials from your email:

Create .env file 
cp .env.example .env
nano .env

Add your credentials to .env:

.env contents 
# GitHub token (required for Shell installation)
GITHUB_TOKEN=your_github_token_here

# Docker Hub credentials (required for Docker installation)
DOCKER_USERNAME=your_docker_username
DOCKER_TOKEN=your_docker_password

Step 4: Login to Docker Registry

Run the login script to authenticate with Docker Hub:

Login to Docker Registry 
chmod +x docker_login.sh
./docker_login.sh

Step 5: Start Services

Start Healenium Pro with Playwright 
docker compose -f docker-compose-pro-playwright.yaml up -d

This will start: PostgreSQL, Healenium Backend, Proxy, Selector Imitator, AI Service, UI Dashboard, Playwright Server, Playwright Proxy.

Step 6: Verify

Check Docker services 
docker compose ps
Shell + Selenium
Prerequisites: PostgreSQL 15+, Java 11+, Python 3.8+. Selenium Server must be running separately.

Step 1: Receive Access Credentials

After purchasing Healenium Pro, you will receive an email with: GitHub Token, Docker Hub username, Docker Hub password, License information.

Important: Keep these credentials secure. You'll need them to download Pro components.

Step 2: Download Configuration Files

Clone the Healenium Pro configuration:

Clone repository 
git clone https://github.com/healenium/healenium.git
cd healenium/pro

Step 3: Configure Credentials

Create and configure the .env file with credentials from your email:

Create .env file 
cp .env.example .env
nano .env

Add your credentials to .env (GitHub token is required for Shell installation):

.env contents 
# GitHub token (required for Shell installation)
GITHUB_TOKEN=your_github_token_here

# Docker Hub credentials (required for Docker installation)
DOCKER_USERNAME=your_docker_username
DOCKER_TOKEN=your_docker_password

Step 4: Setup PostgreSQL Database

Create database and user:

Create database and user 
CREATE DATABASE healenium;
CREATE USER healenium_user WITH PASSWORD 'YDk2nmNs4s9aCP6K';
GRANT ALL PRIVILEGES ON DATABASE healenium TO healenium_user;

Run initialization script:

Initialize database 
psql -U healenium_user -d healenium -f db/sql/init.sql

Step 5: Download Pro Artifacts

Navigate to shell-installation and run:

Download Selenium artifacts 
cd shell-installation
chmod +x selenium_download_pro.sh
./selenium_download_pro.sh

Step 6: Start Selenium Hub

Download and start Selenium Hub 
wget https://github.com/SeleniumHQ/selenium/releases/download/selenium-4.16.0/selenium-server-4.16.0.jar
java -jar selenium-server-4.16.0.jar standalone --port 4444

Selenium Hub: http://localhost:4444

Step 7: Start Healenium Services

Start Healenium Pro (Selenium) 
chmod +x selenium_start_pro.sh
./selenium_start_pro.sh

Step 8: Verify

Check running processes 
jps -l
ps aux | grep app.py
ls -la pid-*.file
Shell + Playwright
Prerequisites: PostgreSQL 15+, Java 11+, Python 3.8+. Playwright Server must be running separately.

Step 1: Receive Access Credentials

After purchasing Healenium Pro, you will receive an email with: GitHub Token, Docker Hub username, Docker Hub password, License information.

Important: Keep these credentials secure. You'll need them to download Pro components.

Step 2: Download Configuration Files

Clone the Healenium Pro configuration:

Clone repository 
git clone https://github.com/healenium/healenium.git
cd healenium/pro

Step 3: Configure Credentials

Create and configure the .env file with credentials from your email:

Create .env file 
cp .env.example .env
nano .env

Add your credentials to .env (GitHub token is required for Shell installation):

.env contents 
# GitHub token (required for Shell installation)
GITHUB_TOKEN=your_github_token_here

# Docker Hub credentials (required for Docker installation)
DOCKER_USERNAME=your_docker_username
DOCKER_TOKEN=your_docker_password

Step 4: Setup PostgreSQL Database

Create database and user:

Create database and user 
CREATE DATABASE healenium;
CREATE USER healenium_user WITH PASSWORD 'YDk2nmNs4s9aCP6K';
GRANT ALL PRIVILEGES ON DATABASE healenium TO healenium_user;

Run initialization script:

Initialize database 
psql -U healenium_user -d healenium -f db/sql/init.sql

Step 5: Download Pro Artifacts

Navigate to shell-installation and run:

Download Playwright artifacts 
cd shell-installation
chmod +x playwright_download_pro.sh
./playwright_download_pro.sh

Step 6: Start Playwright Server

Install and start Playwright Server 
npm install -g playwright@1.55.1
npx playwright run-server --host 0.0.0.0 --port 5050

Playwright Server: ws://localhost:5050

Step 7: Start Healenium Services

Start Healenium Pro (Playwright) 
chmod +x playwright_start_pro.sh
./playwright_start_pro.sh

Step 8: Verify

Check running processes 
jps -l
ps aux | grep app.py
ls -la pid-*.file

Service Ports

ServicePortDescription
Healenium Backend7878Core healing engine API
Healenium Proxy8085WebDriver proxy with healing
UI Dashboard5173Web interface for reports
AI Service6565AI-powered healing service
PostgreSQL5432Database for healing data
Selector Imitator8000Selector generation service
Selenium Hub4444Selenium Grid (Selenium setup)
Playwright Server5050Playwright remote server (PW only)
Playwright Proxy8095Playwright proxy (PW only)

Stopping Services

Docker:

Stop Docker services 
docker compose down
# With volumes: docker compose down -v

Shell:

Stop Shell services 
cd shell-installation
for pid_file in pid-*.file; do
  if [ -f "$pid_file" ]; then
    kill $(cat "$pid_file") 2>/dev/null
    rm "$pid_file"
  fi
done

Troubleshooting

Docker: Cannot pull images

Verify and re-login 
cat .env | grep DOCKER
./docker_login.sh

Shell: Cannot download artifacts

Verify GitHub token 
cat ../.env | grep GITHUB_TOKEN
curl -H "Authorization: token "YOUR_TOKEN" https://api.github.com/repos/healenium/aws-healenium-pro/releases/latest
Previous
<< Healenium-Web
Next
AI & GitHub Integration >>
About Healenium
Help
Contacts
  • Dmitriy_Gumeniuk@epam.com - Project Supervisor