Skip to main content
This guide provides comprehensive instructions for installing UTMStack v11 on Ubuntu 24.04 LTS using the installer script.
Alternative Installation Method: You can also install UTMStack using an automated ISO image. See the Installation from ISO guide for details.

​
Prerequisites

​
Operating System

This installation guide is designed for Ubuntu 24.04 LTS. UTMStack v11 also supports Red Hat systems.

​
System Requirements

The following recommendations are based on the number of data sources and desired hot log storage retention.

​
Definitions

  • Hot log storage: Non-archived data that can be accessed for analysis at any time
  • Cold log storage: Archived data that must be restored before accessing
  • Data source: Any individual source of logs (devices, agents, SaaS integrations)

​
Sizing Guidelines

Assumption: 60 data sources generate approximately 100 GB of monthly data.
Resources needed for one month of hot log storage:

Small Deployment

50 data sources (120 GB hot storage)
  • 4 CPU Cores
  • 16 GB RAM
  • 150 GB Disk Space

Medium Deployment

120 data sources (250 GB hot storage)
  • 8 CPU Cores
  • 16 GB RAM
  • 250 GB Disk Space

Large Deployment

240 data sources (500 GB hot storage)
  • 16 CPU Cores
  • 32 GB RAM
  • 500 GB Disk Space

Enterprise Deployment

500 data sources (1000 GB hot storage)
  • 32 CPU Cores
  • 64 GB RAM
  • 1000 GB Disk Space
You may combine these tiers to allocate resources based on the number of devices and desired hot log storage retention.

​
Required Network Ports

The following ports must be accessible for UTMStack to function properly:

​
Administrative Access Ports

Purpose: Remote server administrationSecurity Recommendation: Create a firewall rule to allow access only from admin workstations
Purpose: UTMStack Web-based GUI redirector (redirects to HTTPS)Security Recommendation: Create a firewall rule to allow access only from admin and security analyst workstations
Purpose: UTMStack Web-based Graphical User InterfaceSecurity Recommendation: Create a firewall rule to allow access only from admin and security analyst workstations
Purpose: Cockpit Web-based Server Management InterfaceSecurity Recommendation: Create a firewall rule to allow access only from admin workstations

​
Integration Ports

Additional ports will be required during the configuration of UTMStack’s integrations to receive logs. Please follow the security recommendations provided in each integration guide.

​
Installation Steps

​
Step 1: Preparing for Installation

Update the system and install required dependencies: 
# Update packages list
sudo apt update

# Install WGET
sudo apt install wget

# Download the latest installer
wget http://github.com/utmstack/UTMStack/releases/latest/download/installer

# Switch to root user
sudo su

# Set execution permissions
chmod +x installer
Make sure you have a stable internet connection during the installation process.

​
Step 2: Running the Installation

Execute the installer without parameters: 
./installer
The installer will:
  1. Check system requirements
  2. Download necessary components
  3. Configure the system
  4. Set up containers and services
  5. Generate initial credentials
The installation process may take 15-30 minutes depending on your internet connection and system resources.

​
Step 3: Post-Installation Configuration

Once UTMStack is installed, you can access the platform:

​
Default Credentials

  • Username: admin
  • Password: Generated during installation
The password and other generated configurations can be found in /root/utmstack.ymlImportant: Store these credentials securely and change the default password immediately after first login.

​
Accessing the Platform

Use HTTPS to access the login page: 
https://your-server-ip
or 
https://your-domain.com
UTMStack requires HTTPS for secure access. HTTP requests will be automatically redirected to HTTPS.

​
Post-Installation Steps

1

Secure Your Credentials

  1. Back up the /root/utmstack.yml file to a secure location
  2. Change the default admin password
  3. Enable and configure Multi-Factor Authentication (MFA) - mandatory in v11
2

Configure Firewall Rules

Set up firewall rules according to the port requirements and security recommendations above
3

Configure SSL Certificate

For production environments, configure a valid SSL certificate:
  • Use Let’s Encrypt with Certbot (recommended)
  • Or import your own SSL certificate
See the SSL Certificate configuration guide for detailed instructions
4

Connect Data Sources

Begin connecting your data sources and integrations:
  • Install agents on endpoints
  • Configure log forwarding from network devices
  • Set up SaaS integrations
5

Configure Central Management (Optional)

If you’re managing multiple UTMStack instances, configure central server connectivity for:
  • Centralized updates
  • Remote log submission
  • Unified management

​
Verification

After installation, verify that UTMStack is running correctly: 
# Check container status
docker ps

# Check system logs
docker logs utmstack_backend

# Verify web interface accessibility
curl -k https://localhost
All containers should be in a “healthy” or “running” state.

​
Troubleshooting

Ensure your system meets the minimum requirements for your deployment size. Check available RAM, CPU, and disk space:
free -h
lscpu
df -h
  1. Verify firewall rules allow ports 80 and 443
  2. Check that containers are running: docker ps
  3. Verify HTTPS is being used in the URL
  4. Check system logs: docker logs utmstack_backend
The generated password is stored in /root/utmstack.yml. Access this file as root to recover the credentials.
  1. Remove existing installation: ./installer --remove
  2. Clean up Docker resources: docker system prune -a
  3. Restart the installation process

​
Additional Installation Options

​
Red Hat Installation

UTMStack v11 now supports Red Hat-based systems. The installation process is similar, but uses dnf instead of apt: 
# Update packages
sudo dnf update

# Install WGET
sudo dnf install wget

# Continue with standard installation steps

​
Support and Resources

Official Documentation

Complete documentation library

Community Forum

Ask questions and share knowledge

GitHub Repository

Source code and issue tracking

Contact Support

Get professional assistance
Remember: UTMStack v11 is not compatible with v10. If you’re migrating from v10, do not attempt a direct upgrade. Wait for the official migration tool or contact support for assistance.