Page tree
Skip to end of metadata
Go to start of metadata

Unimus can be deployed using an embedded file-based database (HSQL - only for small deployments), or a full dedicated DB.

You can find the full list of supported DB types and versions here.

Supported databases and versions

DatabaseOldest supported versionNewest supported version
PostgreSQL9.218.0
MariadDB 10.212.2
MYSQL5.79.6
MSSQL14.0 (from 2017)17.0 (from 2025)
HSQLN/AN/A

Recommended DB settings:

For optimal performance and compatibility of your database with Unimus you can find recommend DB settings it he following table.
In case your database use any other collation, please make sure to choose one that is always case-insensitive.

DatabaseCharacters setCollation

PostgreSQL

utf8

C (equivalent to POSIX)

MariadDB 

utf8mb4

utf8mb4_unicode_ci

MYSQL

utf8mb4

utf8mb4_unicode_ci

MSSQL

UCS-2 / UTF-16

Latin1_General_CI

SQL_Latin1_General_CP1_CI

HSQL

NOT RELEVANT

NOT RELEVANT

Using this combination ensures better global language support and consistent case-insensitive behavior in text comparisons.

HSQL (file-based) database considerations

Please note we do not recommend using the HSQL (file-based) database for deploys over 100 devices, and do not support HSQL deploys with 1000+ devices.

Since HSQL is a file based database, that keeps all data in a few flat text-based files, as the DB size grows, performance is severely impacted. If you want to use HSQL long-term, you should:

  • setup data retention policies for both History Jobs and Backups (in "Other Settings")
  • monitor database directory size (it should not reach multi-gigabyte sizes)
  • monitor disk usage of the disk where HSQL stores its data

HSQL databases can get corrupted if the disk on which data is stored runs out of space.

PostgreSQL details

Unimus 2.5 and older support only PostgreSQL 11 and older. Unimus 2.6 added support for newer versions, and the table above shows the full supported range.

To upgrade an existing PostgreSQL database, see Upgrading the PostgreSQL database.

 

 

  • No labels