Installing MariaDB

Step-by-step guide to download and install MariaDB on your local machine for development purposes.

Setting up MariaDB is the first essential step before using any Ambitions Studio resource.

This guide walks you through downloading and installing the latest recommended version, with proper configuration for a local development environment.

---

Download MariaDB

Go to the official download page

Open your browser and visit: https://mariadb.org/download

Choose the Rolling Release version

We recommend selecting the Rolling Release, which includes the latest updates, security patches, and improvements.

Select your operating system

• Windows → Choose the MSI Installer (64-bit)

• Linux → Select your distribution (Ubuntu, Debian, CentOS, etc.)

• macOS → Use Homebrew, or choose another option

macOS (via Homebrew)

brew install mariadb

Once selected, download the appropriate package for your system and proceed to the next step.

---

Install MariaDB

Launch the installer

• Run the downloaded installer

• Click Next to begin the setup

• Accept the license agreement to continue

Configure the root user

• You’ll be prompted to configure the root user (main admin account)

• We recommend setting a strong password, even for local development

• If you prefer no password for quick testing, you may skip it — but only for personal/local use

✅ Be sure to enable: Use UTF8 as the default server character set

⚠️ Avoid leaving the root user unsecured — even locally, it's a bad habit and may cause compatibility issues later.

Configure instance properties

• Unless you have a specific need, leave the default port at 3306

• If you change the port:

  • Make sure it's not used by another service

  • Ensure your firewall or system permissions allow it

Click Next when ready.

---

Finalize installation

• Review your configuration

• Click Install to launch the process

• Wait for the installation to complete

• Once finished, click Finish

---

Installation Complete

MariaDB is now installed on your machine and ready for local use.You can connect to it using HeidiSQL, VSCode extensions, or any client of your choice.

---

You may now continue with the next steps in the setup to connect, configure, and initialize your database for Ambitions Framework.