This guide explains how to deploy the RELIANOID Community Edition virtual machine on AWS using the official Terraform module from the Terraform Registry.

The module provisions automatically:

• VPC with Internet Gateway
• Public Subnet
• Security Group (allowing SSH 22, Web GUI 444)
• EC2 Instance using the RELIANOID Community Edition AMI
• Key Pair for SSH access

Prerequisites #

Install Terraform #

Download Terraform and install it for your OS.
terraform -version

Install AWS CLI #

Download AWS CLI and configure it with your credentials.
aws configure

SSH Key Pair #

You’ll need an SSH key to access the VM. If you don’t already have one:

Note: Users must generate an SSH key pair in the current folder before running Terraform:
ssh-keygen -t rsa -b 4096 -f id_rsa
This creates id_rsa (private key) and id_rsa.pub (public key). Keep the keys in the same directory where Terraform files are stored.

Step 1: Find the Terraform Module #

1. Go to Terraform Registry.
2. Search for relianoid-community.

   
   
   

   
   

3. Select the official module relianoid/relianoid-community.

   
   
   

   
   

Step 2: Create a Project Folder #

mkdir relianoid-aws
cd relianoid-aws

Step 3: Create main.tf #

module "relianoid-community" {
  source  = "relianoid/relianoid-community/aws"
  version = "1.0.2"

  ami_id              = "ami-0aaa411248ed06acd"  # default US East Marketplace AMI
  public_ssh_key_path  = "${path.module}/id_rsa.pub"
}

outputs.tf #

output "instance_id" {
  description = "The ID of the EC2 instance"
  value = module.relianoid-community.instance_id
}
output "instance_public_ip" {
  description = "The public IP of the EC2 instance"
  value = module.relianoid-community.instance_public_ip
}
output "instance_private_ip" {
  description = "The private IP of the EC2 instance"
  value = module.relianoid-community.instance_private_ip
}

Notes: #

• Users must generate an SSH key pair in the current folder before running Terraform:
  ssh-keygen -t rsa -b 4096 -f ./id_rsa -N ""
• The module internally provisions all required AWS resources, including VPC, Subnet, Security Group, EC2 instance, and key pair.
• Users can override ami_id if they wish to use a different AMI.

Step 4: Initialize & Deploy #

Run the following:

terraform init
terraform plan
terraform apply

Confirm with yes when prompted.

Step 5: Access the RELIANOID VM #

After deployment, Terraform outputs the public IP address. Connect using SSH:
ssh -i id_rsa admin@<instance_public_ip>
Then open the Web GUI in your browser:
https://<instance_public_ip>:444

Outputs #

Terraform provides:

Output Name	Description
instance_id	ID of the EC2 instance
instance_public_ip	Public IP of the VM
instance_private_ip	Private IP of the VM in the VPC

Destroy Resources #

To delete everything created:
terraform destroy

Important Notes: #

• The AMI ID used is for us-east-1. If you deploy in another region, replace it with the correct Marketplace AMI.
• Always secure your private key (id_rsa).