Skip to main content

AWS Single Node Installation

This guide describes how to install the Low-Ops on a single AWS EC2 instance.

warning

This setup is suitable for testing and development environments. For production use, we recommend using a multi-node setup with proper high availability.

Prerequisites
  • AWS Console access with permissions to create EC2 instances and security groups
  • Available domain name with DNS management access
  • Ubuntu 22.04 LTS
Minimum system requirements
  • RAM: 16 GB
  • CPU: 8 vCPUs
  • Disk: 500 GB

Configure Foundation​

Step 1. Create EC2 instance​

Login to the AWS Console, navigate to the EC2 service and click on "Launch Instance".

Launch Instance

Step 2. Configure instance​

Configure instance Name and OS AMI type (Tested on Ubuntu 22.04).

OS Image Name

Step 3. Configure instance type​

Configure instance type, recommended t3.2xlarge or similar (Minimum resources required: 8vCPU, 16GB RAM). Make sure to enable T2/T3 unlimited for consistent performance.

Select Instance Type

Step 4. Configure Networking and Storage​

Configure Networking and Storage instance settings.

     Network: Create a new VPC or use existing one.

     Security Group: Create new with following inbound rules:

           • SSH (22) from your IP

           • HTTP (80) from anywhere

           • HTTPS (443) from anywhere

     Storage: 500 GB GP3 volume for root.

     Tags: Add appropriate tags for resource management.

Networking and Storage

Step 5. Launch EC2 instance.​

Launch EC2 instance.

Launch

Configure DNS record.​

Configure wildcard A record pointing to server public IP address within DNS provider of your choice. Example: If your domain is paas.company.com, create an A record for \*.paas.company.com pointing to your EC2 instance's public IP. Wait for DNS propagation (can take up to 48 hours, but usually much faster)

Install Low-Ops​

Step 1. Connect to your EC2 instance​

Connect to your EC2 instance via SSH.

ssh -i your-key.pem ubuntu@your-ec2-public-ip

Step 2. Install Low-Ops.​

curl -sO https://raw.githubusercontent.com/cinaq/helm-charts/refs/heads/main/charts/lowops-platform/scripts/install-platform.sh
  && chmod +x install-platform.sh
  && ./install-platform.sh

During installation process you will be prompted to input: base domain name (For instance if your portal should be available at portal.paas.company.com. Base domain is paas.company.com).

Docker registry credentials. Current dockerhub pull image limits requires at list pro plan PAT for successfull installation.

Wait until lowops-platform pod in lowops-devops namespace status is Completed. Usually takes 20-30 minutes.

After installation completes, you can access the platform portal using the credentials from the script output.

Access Low-Ops​

Access the Low-Ops at https://portal.your.domain.com