Skip to main content
This guide provides comprehensive instructions for installing UTMStack on Ubuntu 22.04 LTS using either the installer file or ISO image method. This installation guide provides instructions to perform the UTMStack installation on Ubuntu 22.04 LTS.
Before proceeding with installation, review the System Requirements to ensure your server has adequate resources.

​
Installation Methods

UTMStack can be installed using two methods:

Installer File

Download and run the installer script on Ubuntu 22.04 LTS

ISO Image

Boot from UTMStack ISO for a streamlined installation experience

​
Method 1: Installer File Installation

This method involves downloading and executing the UTMStack installer on an existing Ubuntu 22.04 LTS installation.

​
Preparing for Installation

1

Update Package List

Ensure your system has the latest package information:
sudo apt update
2

Install WGET

Install wget if it’s not already available:
sudo apt install wget
3

Download the Installer

Download the latest version of the UTMStack installer from GitHub:
wget http://github.com/utmstack/UTMStack/releases/latest/download/installer
This will download the installer to your current directory.
4

Switch to Root User

Change to the root user for installation:
sudo su
5

Set Execute Permissions

Make the installer executable:
chmod +x installer

​
Running the Installation

1

Execute the Installer

Run the installer without parameters:
./installer
The installer will automatically configure and deploy UTMStack components.
2

Wait for Completion

The installation process may take several minutes. The installer will:
  • Download required Docker images
  • Configure system services
  • Set up networking and databases
  • Generate secure credentials
  • Initialize the UTMStack platform

​
Post-Installation

Once UTMStack is installed:
Use admin as the username and the password generated during the installation to login. You can find the password and other generated configurations in /root/utmstack.yml
Access the Platform: 
https://your-server-ip-or-hostname
Always use HTTPS (not HTTP) in front of your server name or IP to access the login page.

​
Method 2: ISO Image Installation

For a streamlined installation experience, you can use the UTMStack ISO image.

Download UTMStack ISO

Download the latest UTMStack ISO image for installation
1

Download ISO

Visit utmstack.com/install to download the ISO image.
2

Create Bootable Media

Burn the ISO to a DVD or create a bootable USB drive using tools like:
  • Rufus (Windows)
  • dd command (Linux)
  • balenaEtcher (Cross-platform)
3

Boot from ISO

Boot your server from the ISO image and follow the on-screen installation wizard.
4

Access the System

After installation, the default Ubuntu Server credentials are:
user: utmstack
password: utmstack
Change these default credentials immediately after first login for security.

​
Required Network Ports

Ensure the following ports are accessible through your firewall:
PortProtocolServiceAccess Restriction
22TCPSecure Shell (SSH)Admin workstations only
80TCPHTTP RedirectorAdmin and analyst workstations only
443TCPUTMStack Web UI (HTTPS)Admin and analyst workstations only
9090TCPCockpit Web InterfaceAdmin workstation only
Security Best Practices:
  • Create firewall rules to restrict access to these ports based on the recommendations above
  • Never expose port 22 (SSH) to the public internet
  • Always use strong passwords and enable 2FA for user accounts
Additional ports will be required during the configuration of UTMStack’s integrations to receive logs. Please follow the security recommendations given in each integration guide.

​
Verifying Installation

After installation, verify that UTMStack is running correctly:
1

Check Service Status

Verify that Docker containers are running:
docker ps
You should see multiple UTMStack containers running.
2

Access Web Interface

Open your browser and navigate to:
https://your-server-ip
You should see the UTMStack login page.
3

Review Configuration

Check the generated configuration file:
cat /root/utmstack.yml
This file contains important credentials and configuration details.

​
Troubleshooting

  • Verify firewall rules allow access to port 443
  • Check that Docker containers are running: docker ps
  • Ensure you’re using HTTPS, not HTTP
  • Verify the server IP address is correct
  • Ensure your system meets the minimum requirements
  • Check internet connectivity for downloading Docker images
  • Verify you have sufficient disk space
  • Review installation logs for specific error messages
The admin password is stored in /root/utmstack.yml. Access this file with root privileges:
sudo cat /root/utmstack.yml

​
Next Steps

Quick Start Guide

Complete first login and initial configuration

Configure Integrations

Connect your data sources and start collecting logs

Set Up Users

Create accounts for your security team

System Requirements

Review resource requirements for scaling

Build docs developers (and LLMs) love

Get started for freeTalk to us