This guide explains how to deploy the RELIANOID Enterprise 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 Enterprise 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 #
- Go to Terraform Registry.
- Search for
relianoid-enterprise
. - Select the official module
relianoid/relianoid-enterprise
.
Step 2: Create a Project Folder #
mkdir relianoid-aws cd relianoid-aws
Step 3: Create main.tf
#
module "relianoid-enterprise" { source = "relianoid/relianoid-enterprise/aws" version = "1.0.2" ami_id = "ami-0169776ce0edf5fc5" # 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-enterprise.instance_id } output "instance_public_ip" { description = "The public IP of the EC2 instance" value = module.relianoid-enterprise.instance_public_ip } output "instance_private_ip" { description = "The private IP of the EC2 instance" value = module.relianoid-enterprise.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
).