This guide installs OpenIAM on a Linux host. OpenIAM follows a microservices architecture and can be deployed using RPM packages, Docker containers, or Kubernetes.
openiam.com for license validation# Validate internet connectivity
curl https://openiam.com/; echo $?
# Update system packages
sudo dnf update -y
# Install required system tools
sudo dnf install -y curl wget tar gzip
# Download the latest stable version (4.2.2 as of Dec 2025)
curl https://download.openiam.com/release/enterprise/4.2.2/rpm/openiam-4.2.2.noarch.x86_64.rpm --output openiam-4.2.2.noarch.x86_64.rpm
# Install OpenIAM
sudo rpm -i openiam-4.2.2.noarch.x86_64.rpm
# Initialize the OpenIAM platform
sudo openiam-cli init
During initialization, you’ll be prompted to configure:
# Start all OpenIAM services
sudo openiam-cli start
# Check service status
sudo openiam-cli status
# Install Docker on RHEL-based systems
sudo dnf install -y docker docker-compose-plugin
sudo systemctl enable docker
sudo systemctl start docker
mkdir openiam-docker && cd openiam-docker
Create docker-compose.yml:
version: '3.8'
services:
openiam-db:
image: mariadb:10.6
environment:
MYSQL_ROOT_PASSWORD: openiam_root_password
MYSQL_DATABASE: openiam
MYSQL_USER: openiam_user
MYSQL_PASSWORD: openiam_password
volumes:
- db_data:/var/lib/mysql
restart: unless-stopped
openiam:
image: openiam/openiam:4.2.2
depends_on:
- openiam-db
ports:
- "9080:9080"
environment:
DB_HOST: openiam-db
DB_NAME: openiam
DB_USER: openiam_user
DB_PASSWORD: openiam_password
volumes:
- ./config:/opt/openiam/config
restart: unless-stopped
volumes:
db_data:
docker-compose up -d
# Check service health
curl http://localhost:9080/openiam-esb/actuator/health
curl -k https://localhost:9080/idp/actuator/health
# Check logs if needed
sudo openiam-cli log ui
sudo openiam-cli log esb
sysadminpasswd00https://your-server:9080https://your-server:9080# Check all service statuses
sudo openiam-cli status
# View specific service logs
sudo openiam-cli log <service_name>
# Restart services
sudo openiam-cli restart
# Stop services before system reboot
sudo openiam-cli stop
Setting up identity management systems can be complex. We offer consulting services for:
Contact us at office@linux-server-admin.com or visit our contact page.