Lab Environment Setup¶

Section: Getting Started | Article 64
Audience: System Administrators, Support Engineers
Last Updated: 2026-04-08

Overview¶

RP-PAM includes lab bootstrap scripts that set up a complete development and testing environment with one command. The lab includes all infrastructure dependencies (database, LDAP directory, Redis) running as Docker containers.

Use this for: - Evaluating RP-PAM before production deployment - Testing upgrades before applying to production - Training new administrators - Module development and testing

Prerequisites¶

Requirement	Details
Docker	Docker Engine 24+ (Linux) or Docker Desktop (Windows)
Docker Compose	v2.20+ (included with Docker Desktop)
CPU	4 cores minimum
RAM	8 GB minimum (MSSQL alone needs 2 GB)
Disk	20 GB free

Quick Start — Docker Compose¶

The fastest way to get a lab running:

cd build/lab
docker compose -f docker-compose.lab.yml up -d

This starts:

Service	Port	Credentials
MSSQL 2022	1433	`sa` / `RpPamLab2026!`
ApacheDS (LDAP)	10389	Default admin
Redis 7	6379	Password: `RpPamLabRedis!`

Full Bootstrap — Linux¶

The Linux bootstrap script installs Docker (if needed) and sets up everything:

sudo bash build/lab/rppam-lab-setup.sh

What it does: 1. Checks/installs Docker and Docker Compose 2. Pulls all container images 3. Starts the lab environment 4. Waits for all services to be healthy 5. Creates the RP-PAM database 6. Displays connection details

Full Bootstrap — Windows¶

.\build\lab\rppam-lab-setup.ps1

Note: Docker Desktop must be installed first. The script will prompt if it's not found.

After Setup¶

Once the lab is running:

  ┌────────────────────────────────────────────┐
  │  RP-PAM Lab Environment                    │
  ├────────────────────────────────────────────┤
  │  Portal:   http://localhost:7101           │
  │  Admin:    admin / RpPamLabAdmin!          │
  │  MSSQL:    localhost:1433 (sa)             │
  │  LDAP:     localhost:10389                 │
  │  Redis:    localhost:6379                  │
  └────────────────────────────────────────────┘

Managing the Lab¶

# Stop the lab (preserves data)
docker compose -f docker-compose.lab.yml down

# Stop and delete all data (clean reset)
docker compose -f docker-compose.lab.yml down -v

# View logs
docker compose -f docker-compose.lab.yml logs -f

# Restart a specific service
docker compose -f docker-compose.lab.yml restart mssql

Next Steps¶

Setup Wizard — Configure RP-PAM against the lab database
Active Directory Module — Test AD integration with the lab ApacheDS
Building Custom Modules — Develop modules in the lab