Quickstart, Requirements: MariaDB Packages

[oxzi]

Add copy-pasteable MariaDB package installs to the "Requirements" subsection. While the required versions were already part of the written text, they are easy to miss when just copying all commands from the code boxes.

Package Versions

The package names were verified within containers using the latest stable release of each distribution.

• Ubuntu

    root@0feec603c37f:/# grep PRETTY_NAME /etc/os-release
    PRETTY_NAME="Ubuntu 26.04 LTS"
    root@0feec603c37f:/# apt-cache search mariadb-server
    mariadb-server - MariaDB database server binaries
    mariadb-server-core - MariaDB database core server files
    mariadb-server-compat - MySQL compatibility links to mariadb-server binaries/scripts

• Debian

    root@06368930dfdb:/# grep PRETTY_NAME /etc/os-release
    PRETTY_NAME="Debian GNU/Linux 13 (trixie)"
    root@06368930dfdb:/# apt-cache search mariadb-server
    mariadb-server - MariaDB database server binaries
    mariadb-server-10.5 - MariaDB database server binaries (transitional dummy package)
    mariadb-server-compat - MySQL compatibility links to mariadb-server binaries/scripts
    mariadb-server-core - MariaDB database core server files

• SLES

    56d6e2f43759:/ # grep PRETTY_NAME /etc/os-release
    # The NAME and PRETTY_NAME fields have been chosen to state compatibility between our products.
    PRETTY_NAME="SUSE Linux Enterprise Server 16.0"
    56d6e2f43759:/ # zypper search mariadb
    Refreshing service 'container-suseconnect-zypp'.
    Loading repository data...
    Reading installed packages...

    S  | Name                   | Summary                                                             | Type
    ---+------------------------+---------------------------------------------------------------------+--------
       | libmariadb-devel       | Development files for the MariaDB Connector C API                   | package
    i  | libmariadb3            | MariaDB connector in C                                              | package
       | libmariadb_plugins     | Plugins for the MariaDB C Connector                                 | package
       | libmariadbd-devel      | MariaDB embedded server development files                           | package
       | libmariadbd19          | MariaDB embedded server library                                     | package
       | libmariadbprivate      | Additional internal libraries for the MariaDB C Connector           | package
    i+ | mariadb                | Server part of MariaDB                                              | package
       | mariadb-bench          | Benchmarks for MariaDB                                              | package
    i  | mariadb-client         | Client for MariaDB                                                  | package
       | mariadb-connector-odbc | MariaDB ODBC Connector                                              | package
    i  | mariadb-errormessages  | The error messages files required by server, client and libmariadbd | package
       | mariadb-tools          | MariaDB tools                                                       | package

• RHEL

    [root@c5c751c1c6a5 /]# grep PRETTY_NAME /etc/os-release
    PRETTY_NAME="Red Hat Enterprise Linux 10.2 (Coughlan)"
    [root@c5c751c1c6a5 /]# dnf search mariadb-server
    Updating Subscription Management repositories.
    Last metadata expiration check: 0:02:13 ago on Mon Aug  3 06:53:15 2026.
    ============================================================================================= Name Exactly Matched: mariadb-server =============================================================================================
    mariadb-server.x86_64 : The MariaDB server and related files
    ================================================================================================= Name Matched: mariadb-server =================================================================================================
    mariadb-server-galera.x86_64 : The configuration files and scripts for galera replication
    mariadb-server-utils.x86_64 : Non-essential server utilities for MariaDB/MySQL applications

---

I have created this PR as this was once more an issue for a new user brought forward in the Community Forum, https://community.icinga.com/t/setup-new-server-do-i-need-to-manually-install-mysql-mariadb/15546.

Fixes #15.

[jrauh01]

When installing the MariaDB package, all code examples, section titles, and prompt comments should be adjusted from mysql to mariadb as well.

Personally I would add the package install to tab-install-icinga.md where all the other packages get installed. The service start could then be moved to the section "Set up MySQL Databases" "Set up MariaDB Databases".

[oxzi]

Thanks for the review, @jrauh01. I somehow missed it and thus my response is a bit delayed.

After merging #21 and rebasing, I moved the package installation to the tab-install-icinga.md file, as suggested. However, I would continue referring to MySQL instead of MariaDB in the written text, as this is also the keyword used in Icinga Web 2. Furthermore, MariaDB comes with a mysql-compatible binary.

[oxzi]

Furthermore, MariaDB comes with a mysql-compatible binary.

Well, this aged well. Just got this warning:

mysql: Deprecated program name. It will be removed in a future release, use '/nix/store/m5l2vlwq15153rgs9x1k7vsdv8lfccc8-mariadb-server-11.4.12/bin/mariadb' instead

I'm going to change this when I get back from vacation.