Installation Guide

Deploy Realm9 on Kubernetes to manage multi-cloud environments

Currently supported on AWS EKS • Azure AKS and GCP GKE coming soon

Installation Overview

Realm9 is deployed on Kubernetes using Helm. Once installed, it can manage environments across AWS, Azure, GCP, and on-premise infrastructure.

1

Setup Cluster

Create EKS cluster (optional if you have one)

2

Prepare Resources

S3 buckets, domain, secrets

3

Configure Values

Database, AWS, email, ingress

4

Install Realm9

Deploy with Helm

Prerequisites

Before installing Realm9, ensure you have the following ready.

Required Tools

  • Kubernetes cluster v1.24+ (AWS EKS recommended)
  • kubectl configured to access your cluster
  • Helm 3.x installed
  • AWS CLI v2 (if creating new EKS cluster)
  • Domain name (for accessing Realm9 UI)

AWS Resources (Mandatory)

These AWS resources are required for Realm9 to function, even if managing multi-cloud environments.

  • AWS Account ID: Your AWS account identifier
  • Primary Region: us-east-1 (recommended for consistency)
  • S3 Buckets (2 required):
    • Terraform state bucket (e.g., realm9-terraform-state)
    • Application data bucket (e.g., realm9-data)
  • DynamoDB Table: For Terraform state locking (e.g., terraform-state-locks)
  • IAM Role: With permissions for managing AWS resources
  • Email Service: AWS SES configured with verified domain/email OR SMTP credentials
  • Domain Name: For accessing Realm9 (e.g., realm9.yourdomain.com)
  • SSL Certificate: For HTTPS (can use cert-manager with Let's Encrypt)

Verify Prerequisites

# Check kubectl
kubectl version --client

# Check Helm
helm version

# Check AWS CLI
aws --version

# Verify cluster access
kubectl get nodes

Helm Chart Reference

Official Realm9 Helm chart hosted on AWS ECR Public

oci://public.ecr.aws/m0k6f4y3/realm9/realm9
View on ECR