Skip to content

Azure Single node installation

Overview

This guide describes how to install the LowOps platform on a single Azure Virtual Machine. This setup is suitable for testing and development environments. For production use, we recommend using a multi-node setup with proper high availability.

Prerequisites

  • Azure Portal access with permissions to create Virtual Machines and Network Security Groups
  • Available domain name with DNS management access
  • Minimum system requirements:
  • RAM: 16 GB
  • CPU: 8 vCPUs
  • Disk: 500 GB
  • Ubuntu 22.04 LTS

Installation steps

1. Create Azure Virtual Machine

  1. Log in to Azure Portal
  2. Navigate to Virtual Machines
  3. Click Create and select Azure virtual machine

Azure VM

  1. Configure basic settings:
  2. Subscription: Select your subscription
  3. Resource group: Create new or select existing
  4. Virtual machine name: Enter a name
  5. Region: Select your preferred region
  6. Image: Ubuntu Server 22.04 LTS
  7. Size: Select a VM size with minimum 8 vCPUs and 16GB RAM (e.g., Standard_D8s_v3)

Azure VM Basics

  1. Configure Administrator account:
  2. Authentication type: SSH public key
  3. Username: azureuser
  4. SSH public key source: Generate new key pair or use existing

Azure VM Size

  1. Configure networking:
  2. Virtual network: Create new or select existing
  3. Subnet: Create new or select existing
  4. Public IP: Yes
  5. NIC network security group: Advanced
  6. Configure network security group with following inbound rules:
    • SSH (22) from your IP
    • HTTP (80) from anywhere
    • HTTPS (443) from anywhere

Azure VM Networking

  1. Configure storage:
  2. OS disk type: Premium SSD
  3. OS disk size: 500 GB

Azure VM Storage

  1. Review and create the VM

Azure VM Create

2. Configure DNS record

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

3. Install LowOps Platform

  1. SSH into your Azure VM: 

    ssh azureuser@your-vm-public-ip

  2. Run command to start platform installation: 

    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

  3. During installation process you will be prompted to input:

  4. base domain name (For instance if your portal should be available at portal.paas.company.com. Base domain is paas.company.com)

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

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

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

4. Post-Installation