This ISO provides a streamlined, automated installation of UTMStack v11 Community Edition on Ubuntu 24.04.3 LTS. It applies predefined system settings and runs the UTMStack installer automatically on first boot, making it ideal for production deployments with minimal manual intervention.
The ISO is designed for virtual machine environments and requires interactive configuration during the initial setup process.
Key Features
The system includes basic security hardening and comes with essential system utilities preinstalled.
System Requirements
Before attaching the ISO to your VM, ensure it meets the following requirements:
| Component | Minimum | Recommended |
|---|---|---|
| RAM | 16 GB | 32 GB or more |
| vCPUs | 4 vCPUs | 8 vCPUs or more |
| Disk Space | 120 GB | 150 GB SSD or larger |
| Network | Active connectivity | 1 Gbps connection |
See System Requirements for detailed specifications based on your deployment size and expected data volume.
Installation Flow
The installation process is designed to be straightforward with minimal user input required:
Step 1: Download the ISO
Download the UTMStack v11 Community Edition ISO:
Download utmstack-v11-autoinstall.iso
Save the ISO file to a location accessible to your virtualization platform.
Step 2: Attach ISO and Boot
Attach the UTMStack ISO to your virtual machine and boot from it. The automated installer will launch automatically.
Step 3: Create User Credentials
During installation, you will be prompted to:
Create a username (no default credentials exist)
Set a strong password
Store these credentials securely - they are required for all future system access.
Step 4: Configure Network Settings
Choose your network configuration:
DHCP (automatic IP assignment)
Static IP (manual configuration)
Ensure your network settings allow outbound connectivity for package downloads.
Step 5: Automatic Package Installation
The system automatically installs essential packages:
openssh-server- Remote SSH accesscurl,wget- Network utilitiesgit- Version controlvim- Text editorhtop- Process monitornet-tools- Network utilities
Step 6: First Boot Configuration
On first boot, the following occurs automatically:
UTMStack installer launches
Custom MOTD with UTMStack branding displays
Installation logs begin writing to
/var/log/utmstack/
The entire installation process typically takes 15-30 minutes depending on hardware and network speed.
Post-Installation Steps
1. Log In
Once installation completes, log in using the credentials you created during the setup process.
# Login via console or SSH
ssh username@your-server-ipSSH is enabled by default and ready for remote access immediately after installation.
2. Monitor Installer Progress
The UTMStack installer runs automatically on first boot. Monitor its progress:
grep -i error /var/log/utmstack/installer.logcat /var/log/utmstack/installer.logtail -n 50 /var/log/utmstack/installer.logtail -f /var/log/utmstack/installer.logKeep the log monitoring terminal open during installation to catch any potential issues in real-time.
3. Optional Setup Wizard
After the main installation completes, you can run the setup wizard to configure additional settings:
utmstack-setupWhat does the setup wizard configure?
The setup wizard currently handles:
Timezone configuration - Set your local timezone
Note: The hostname is already configured during the initial installation process and does not need to be set again.
4. System Verification
After installation, verify your system is configured correctly:
lsb_release -a
Expected: Ubuntu 24.04.3 LTSInstalled Scripts and Symlinks
All UTMStack scripts are centrally located for easy management and access.
Script Location
Primary Directory: /opt/utmstack/
start.sh
Purpose: Main UTMStack installer launcher
Execution: Runs automatically on first boot
Manual Run:
sudo /opt/utmstack/start.shfinish-install-setup.sh
Purpose: Post-installation setup wizard (timezone configuration)
Execution: Optional, run manually after installation
Symlink: utmstack-setup
Convenient Symlinks
For quick access, symlinks are created under /usr/local/bin/:
utmstack-install → /opt/utmstack/start.sh
utmstack-setup → /opt/utmstack/finish-install-setup.shYou can run these commands from any directory without specifying the full path.
Log Files
All installation and system logs are centralized for easy troubleshooting.
Log Location
Primary Log Directory: /var/log/utmstack/
| Log File | Purpose |
|---|---|
| installer.log | Main installation process log |
| Additional logs | Created by UTMStack services as they start |
sudo cat /var/log/utmstack/installer.logTroubleshooting
Installation appears stuck
Solution:
Check the installer log for errors:
```plaintext
```plaintext
```plaintext
```plaintext
```plaintext
```plaintext
```plaintext
```plaintext
```plaintext
tail -f /var/log/utmstack/installer.log
```plaintext
2. Verify network connectivity:
```bash
ping -c 3 8.8.8.8Check if the installer process is running:
```plaintext
```plaintext
```plaintext
```plaintext
```plaintext
```plaintext
```plaintext
```plaintext
```plaintext
ps aux | grep utmstack
```plaintext
</AccordionTab>
<AccordionTab title="Cannot connect via SSH" >
**Solution**:
1. Verify SSH service is running:
```bash
sudo systemctl status sshCheck firewall rules:
```plaintext
```plaintext
```plaintext
```plaintext
```plaintext
```plaintext
```plaintext
```plaintext
```plaintext
sudo ufw status
```plaintext
3. Verify network configuration:
```bash
ip addr showInstaller failed with errors
Solution:
Review the complete log:
```plaintext
```plaintext
```plaintext
```plaintext
```plaintext
```plaintext
```plaintext
```plaintext
```plaintext
cat /var/log/utmstack/installer.log
```plaintext
2. Check for specific error messages
3. Verify system resources meet requirements
4. Contact support with log file if issue persists
</AccordionTab>
<AccordionTab title="Need to re-run the installer" >
**Solution**:
```bash
sudo /opt/utmstack/start.shRe-running the installer may reset existing configurations. Backup any custom settings first.
Security Considerations
Post-Installation Security Recommendations
Configure Firewall
Set up UFW firewall rules to restrict access. See Firewall Rules for detailed configuration.
Enable SSL/TLS
Configure SSL certificates for secure web access. See SSL Certificate for instructions.
Update System
Keep your system updated with the latest security patches:
sudo apt update && sudo apt upgrade -yHarden SSH
Disable password authentication (use keys only)
Change default SSH port
Restrict SSH access by IP
Changelog Summary
Recent improvements to the ISO:
| Feature | Description |
|---|---|
| ✅ Ubuntu 24.04.3 LTS | Updated to the latest Long Term Support release |
| ✅ Community Edition Branding | Complete UTMStack Community Edition branding throughout |
| ✅ Interactive Configuration | New interactive network and identity configuration during setup |
| ✅ Organized Scripts | Scripts moved to /opt/utmstack/ for better organization |
| ✅ Command Symlinks | Convenient symlinks added for easy command access |
| ✅ Centralized Logs | All logs centralized in |
| ✅ SSH Preinstalled | SSH server preinstalled and enabled by default |
| ✅ Auto-execution | Installer runs automatically on first boot |
| ✅ Simplified Setup | Setup script simplified (timezone configuration only) |
| ✅ Verification Commands | Enhanced system verification commands included |
Support and Resources
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.