Ubuntu
UCS is supported on Ubuntu 26.04 (Resolute Raccoon) and 24.04 (Noble Numbat), amd64 architecture. Use Ubuntu 26.04 for new installations. To install, follow these steps:
-
Download the server version and start the installation. Install only OpenSSH server, in the Featured Server Snaps section do not select any option.
-
Download the INSOFT UCS installation package and install it:
#!/bin/bash
timedatectl set-timezone Europe/Prague
apt install postfix
wget https://repo.insoft.cz/apt/pool/stable/i/insoft-repo/insoft-repo_1.0.0-0~ubuntu-resolute_all.deb
apt install ./insoft-repo_1.0.0-0~ubuntu-resolute_all.deb
apt update
apt install insoft-ucs
The insoft-repo package configures the INSOFT and Grafana repositories. On Ubuntu 24.04, use
insoft-repo_1.0.0-0~ubuntu-noble_all.deb.
unattended-upgrades are enabled in the default installation of Ubuntu. During the update, there is a service outage, according to the updated components.
How to turn off automatic updates:
#!/bin/bash
apt purge unattended-upgrades
# To be sure, when reinstalling it will be necessary to confirm the overwriting of the config
cat /etc/apt/apt.conf.d/20auto-upgrades >/dev/null <<EOF
APT::Periodic::Update-Package-Lists "1";
APT::Periodic::Unattended-Upgrade "0";
EOF
The observability stack (Grafana, Loki, Tempo, Prometheus, OpenTelemetry Collector) is not installed automatically. Install it per host where you want local telemetry collection:
apt install insoft-telemetry
This pulls in all five components and configures them. Grafana then
becomes available at https://<server-address>/grafana/ — see
Observability for details on access,
configuration, and telemetry ingestion.
- Continue: First Settings
Operation
Locking the UCS version
If regular OS updates are required, but UCS should only be updated on demand, then it is possible to lock the installed version of UCS:
Lock the currently installed version of UCS:
apt-mark hold 'insoft-*'
apt-mark hold 'ucs-*'
Unlock to update UCS:
apt-mark unhold 'insoft-*'
apt-mark unhold 'ucs-*'
Check which packages are locked:
apt-mark showhold
# list versions
apt list --installed 'ucs-*' 'insoft-*'
Update examples:
# After the initial UCS installation, the following was entered:
apt-mark hold 'insoft-*'
apt-mark hold 'ucs-*'
Updating only system packages
apt-mark hold 'insoft-*'
apt-mark hold 'ucs-*'
apt update
apt upgrade
Updating INSOFT and UCS packages (incl. system packages) and locking them again
apt-mark unhold 'insoft-*'
apt-mark unhold 'ucs-*'
apt update
apt upgrade
apt-mark hold 'insoft-*'
apt-mark hold 'ucs-*'