My Account | Help
You are here: Home / News / Control Panel, CWP / Article #10: How to Fix MariaDB Installation on CWP (AlmaLinux 8) via Manual RPMs When Modular Filtering and DNF Fail

Article #10: How to Fix MariaDB Installation on CWP (AlmaLinux 8) via Manual RPMs When Modular Filtering and DNF Fail

Control Panel, CWP 0 11 minutes ago

If you’ve ever tried updating or installing MariaDB 10.5+ on a Control Web Panel (CWP) server running AlmaLinux or CentOS 8, you’ve likely encountered modular filtering conflicts, broken dependencies, or even disappearing packages. Here’s a complete step-by-step guide on how to cleanly fix MariaDB installation using manual .rpm packages when everything else fails.

📈 Why This Happens

AlmaLinux 8 and similar distros use modular repositories, which can override or block external packages like MariaDB from yum.mariadb.org. Even after disabling modules, DNF may still filter out matching packages.

You might see errors like:

  • All matches were filtered out by modular filtering for argument: MariaDB-server
  • Cannot find repomd.xml
  • Missing dependencies: libboost_program_options.so

✅ Final Working Solution: Manual RPM Installation

This guide installs MariaDB 10.5+ cleanly by bypassing DNF filters and installing directly from .rpm files.

🔧 Step-by-Step Fix

✅ 1. Remove Conflicting Modules & Clean DNF

dnf module reset mariadb -y
dnf module disable mariadb -y
dnf clean all
rm -rf /var/cache/dnf
dnf makecache

✅ 2. Create a Clean Workspace

cd /usr/local/src
mkdir mariadb10.5 && cd mariadb10.5

✅ 3. Download MariaDB 10.5 RPM Files

Use working mirrors (MariaDB’s default links often redirect to 404s):

wget http://mirror.ossplanet.net/mariadb/yum/10.5/centos8-amd64/rpms/MariaDB-server-10.5.28-1.el8.x86_64.rpm
wget http://mirror.ossplanet.net/mariadb/yum/10.5/centos8-amd64/rpms/MariaDB-client-10.5.28-1.el8.x86_64.rpm
wget http://mirror.ossplanet.net/mariadb/yum/10.5/centos8-amd64/rpms/MariaDB-common-10.5.28-1.el8.x86_64.rpm
wget http://mirror.ossplanet.net/mariadb/yum/10.5/centos8-amd64/rpms/MariaDB-shared-10.5.28-1.el8.x86_64.rpm

✅ 4. Install MariaDB Manually

dnf localinstall MariaDB-*.rpm --allowerasing -y

✅ 5. Start and Enable MariaDB

systemctl enable mariadb --now
systemctl status mariadb

✅ You should see active (running)

✅ 6. Secure Installation

mysql_secure_installation

When prompted to use unix_socket authentication, type n to use password login — important for CWP compatibility.

✅ 7. Test Access

mysql -u root -p

ℹī¸ What If I Still Get Errors?

  • Ensure your DNS is working (/etc/resolv.conf should include 1.1.1.1 or 8.8.8.8)
  • Double check that no MariaDB module is enabled: dnf module list mariadb
  • Avoid yum install MariaDB-* until modular filtering is completely disabled

đŸšĢ Avoid These Pitfalls

  • Don’t rely on yum.mariadb.org or downloads.mariadb.com — they often redirect or 404
  • Don’t install MariaDB from AppStream if you want 10.5+ — it only includes 10.3
  • Don’t run mysqld directly as root — always use systemctl start mariadb

✉ī¸ Need Expert Help?

If you’d like our team to install or migrate MariaDB for you safely:

📩 Open a support ticket at Servers9

With this guide, your MariaDB 10.5+ installation should now be working smoothly, ready for your WordPress, CWP apps, and high-performance workloads.