# Installing MariaDB on IBM Cloud

Get MariaDB on IBM Cloud.

You should have an IBM Cloud account, otherwise you can [register here](https://cloud.ibm.com/registration).\
At the end of the tutorial you will have a cluster with MariaDB up and running. IBM Cloud uses Bitnami charts to deploy MariaDB on with helm

1. We will provision a new Kubernetes Cluster for you if, you already have one skip to step **2**
2. We will deploy the IBM Cloud Block Storage plug-in, if already have it skip to step **3**
3. MariaDB deployment

## Step 1 provision Kubernetes Cluster

1. Click the Catalog button on the top.
2. Select Service from the catalog.
3. Search for Kubernetes Service and click on it.

![kubernetes-select](/files/JtMQqWqkMgz9TZv4g0Ug)

4. Choose a plan: standard or free.

{% hint style="info" %}
The free plan includes one worker node and no subnet.
{% endhint %}

5. To provision a standard cluster, upgrade your account to Pay-As-You-Go.
6. To upgrade to a Pay-As-You-Go account, follow these steps:
   1. In the console, go to **Manage > Account**.
   2. Select **Account settings**, and click **Add credit card**.
   3. Enter your payment information, click **Next**, and submit your information.
7. Choose between classic or VPC after reviewing the documentation to determine the most suitable option.

![infra-select](/files/kBUhPXsmiztQxQsREJDk)

8. Now choose your location settings, for more information please visit [Locations](https://cloud.ibm.com/docs/containers?topic=containers-regions-and-zones#zones)
9. Choose **Geography** (continent)

![location-geo](/files/ozxMqvak94SS7JdOjnhC)

10. Select either **Single-Zone** or **Multi-Zone** storage. Single Zone stores your data in one data center, while Multi-Zone distributes your data across multiple zones, offering greater safety in the event of unexpected zone failures.

![location-avail](/files/Mergub0tyLthFfiQJYwZ)

11. Choose a **Worker Zone** if using Single zones or Metro if Multizone

![location-worker](/files/IFfaTrmcAPlkVcIYB8wD)

12. Set up your account with VRF or enable VLAN spanning to use Multizone.
13. If no Virtual LAN is available at your selected location, a new VLAN will be created for you.
14. Choose a Worker node setup or use the preselected one.
15. Set the **Worker node per zone**.

![worker-pool](/files/L2qV2vAo7xISWXvKuLvb)

16. Choose Master Service Endpoint, In VRF-enabled accounts, you can choose **Private endpoint only** to make your master accessible on the private network or via VPN tunnel. Choose **Public endpoint only** to make your master publicly accessible. When you have a VRF-enabled account, your cluster is set up by default to use **Both private and public endpoints**. For more information visit [endpoints](https://cloud.ibm.com/docs/account?topic=account-service-endpoints-overview).

![endpoints](/files/bFoIe7ajVnrAjc4uadvp)

17. Give **Cluster name**

![name-new](/files/PTxOqUIpKwX31VQICF9o)

18. Give desired **Tags** to your cluster, for more information visit [tags](https://cloud.ibm.com/docs/account?topic=account-tag)

![tasg-new](/files/LtAAMXWlWExIJngTKdIG)

19. Click **Create**

![create-new](/files/RTIbRUjP26oxLGa1LVAg)

20. Wait for you cluster to be provisioned

![cluster-prepare](/files/z6cmBas5ttQLJJyDjhg7)

21. Your cluster is ready for usage

![cluster-done](/files/NQEJgCCIOEUxjN8SAT1C)

## Step 2 deploy IBM Cloud Block Storage plug-in

The Block Storage plug-in is a persistent, high-performance iSCSI storage that you can add to your apps by using Kubernetes Persistent Volumes (PVs).

1. Click the **Catalog** button on the top
2. Select **Software** from the catalog
3. Search for *IBM Cloud Block Storage plug-in* and click on it

![block-search](/files/d5l2UIPKcMLMd75UNbJC)

4. On the application page, select the cluster you wish to use
5. Click on **Enter or select namespace** and choose the default Namespace or use a custom one (if you get error please wait 30 minutes for the cluster to finalize)

![block-cluster](/files/6iB37B12MOQdG5h11uu8)

6. Give a **Name** to this workspace
7. Click **Install** and wait for the deployment

![block-storage-create](/files/B7L0PO2RBFRML8yemRYI)

## Step 3 deploy MariaDB

We will deploy MariaDB on our cluster

1. Click the **Catalog** button on the top
2. Select **Software** from the catalog
3. Search for *MariaDB* and click on it

![search](/files/oHrDwCwn6a65PCrtFFl2)

4. Please select **IBM Kubernetes Service**

![target-select](/files/sRO8SKgCQXuLYxoNW23x)

5. On the application page, select the cluster you wish to use

![cluster-select](/files/hQI87i0dJGPrp6wsAZWO)

6. Click on **Enter or select namespace** and choose the default Namespace or use a custom one

![details-namespace](/files/U0X0yzLyJgukqLA9OyRJ)

7. Give a unique name to workspace, which you can easily recognize

![details-name](/files/XPZsrTDISxQiNx3pCaZI)

8. Select which **Resource Group** you want to use, it's for access controll and billing purposes. For more information please visit [resource groups](https://cloud.ibm.com/docs/account?topic=account-account_setup#bp_resourcegroups)

![details-resource](/files/qgmOYWBfK7POwOQUTECj)

9. Give **Tags** to your MariaDB, for more information visit [tags](https://cloud.ibm.com/docs/account?topic=account-tag)

![details-tags](/files/Dh24wfZpVJmkT5aXbpmo)

10. Click on **Parameters with default values**, You can set deployment values or use the default ones

![parameters](/files/Z94NTdlYyiLJP5ynoDwL)

11. Please set the MariaDB root password in the parameters

![root-password](/files/YVjmUJdpklzLuI0cDZ04)

12. After finishing everything, tick the box next to the agreements and click **Install**

![aggreement-create](/files/822bhVKxKL3eAxn2QjrS)

13. The MariaDB workspace will start installing, wait a couple of minutes

![in-progress](/files/D966RM22kjgWTMCe2STd)

14. Your MariaDB workspace has been successfully deployed

![done](/files/ztlZgOsnTv1TfeHTSMgL)

## Verify MariaDB installation

1. Go to [Resources](https://cloud.ibm.com/resources) in your browser
2. Expand **Clusters.** Click on your cluster

![resource-select](/files/hufkDBUQVYb95TjumiKP)

3. On the **Overview** page, click **Actions**, then select **Web Terminal** from the dropdown menu.

![cluster-main](/files/sYX0xZkpTTYQF4BurPgr)

4. Click Install and wait for sometime
5. Click on Actions
6. Click Web terminal. A terminal window will open up
7. On the terminal window, please change NAMESPACE to the namespace you choose at the deployment setup:

```bash
$ kubectl get ns
```

![get-ns](/files/DfQO2ynGBVMVwjLvQO7B)

```bash
$ kubectl get pod -n NAMESPACE -o wide
```

![get-pods](/files/ohX0qkK6sCPUpZd06KEf)

```bash
$ kubectl get service -n NAMESPACE
```

![get-service](/files/obP7FDgaosF2okkNqwRa)

8. Enter your pod with bash , please replace PODNAME with your mariadb pod's name

```bash
$ kubectl exec --stdin --tty PODNAME -n NAMESPACE -- /bin/bash
```

![bash](/files/svypXKpj5zJNLBuH1BAa)

9. After you are in your pod please enter Mariadb and enter your root password after the prompt

```bash
$ mysql -u root -p
```

![welcome](/files/uFw6YvHNZ4Y8SMPEzEIM)

You have successfully deployed MariaDB IBM Cloud!

<sub>*This page is licensed: CC BY-SA / Gnu FDL*</sub>

{% @marketo/form formId="4316" %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://mariadb.com/docs/server/server-management/install-and-upgrade-mariadb/installing-mariadb/installing-mariadb-on-ibm-cloud.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
