Create and manage instances

Prerequisites

• You have a STACKIT customer account: Create a customer account
• You have a STACKIT user account: Create a user account
• You have a STACKIT project: Create a project

Instance properties

Independent of the method you choose to create and manage an instance, there are common properties of a MariaDB instance.

General information

Instance name

With the instance name, you determine the friendly name for your instance.

MariaDB version

With the MariaDB version, you determine which MariaDB version comes to play. STACKIT updates the MariaDB major version according to the releases of MariaDB with a reasonable delay for implementation. Maybe some versions are skipped as well. Read the Release notes for deprecation notices and announcements of new versions. For safety reasons, STACKIT will deprecate MariaDB versions, when they reach their EOL status. Furthermore, STACKIT applies minor updates for security reasons.

Plan

Select the plan which fits your workload. It is safe to start with a smaller flavor and change to a bigger one afterwards. Depending on the MariaDB version you have chosen, some plans are not available. A plan determines the number of nodes, vCPUs, RAM and storage size. For a detailed reference of available plans, read Service plans of MariaDB.

Number of nodes

With the number of nodes, you can determine horizontal scaling and high availability. Horizontal scaling increases availability and read performance. The single plan (1 node) doesn’t feature horizontal scaling. A replica plan (3 nodes) offers horizontal scaling and thus achieves high availability.

Use case	Plan
Development	Single (1 node)
Production (normal)	Replica (3 nodes)

Number of vCPUs

With the number of vCPUs, you determine how much computing power each node of your instance has. Follow Plan your MariaDB instance on how to find the best option for your workload.

RAM

With the RAM setting, you determine how much memory each node of your instance has. Follow Plan your MariaDB instance on how to find the best option for your workload.

Disk size

With the disk size, you determine the size of the underlying storage. The smallest option is 10GB. You can safely apply this size and enlarge the disk afterwards by changing the plan.

You can up- and downgrade the MariaDB plan at any time. Please note that you cannot downgrade the storage size. For all possible operations, you will experience a downtime.

Custom parameters

Disk threshold

MariaDB instances are vulnerable to situations of full storage. To prevent this, STACKIT’s MariaDB offers a parachute feature. It stops the database when a predefined disk usage threshold (in percent) is reached. With this setting, you define this threshold. You can practically deactivate this feature by defining 100% as threshold.

ACL

With the ACL entries, you control which source IPs are allowed to connect to your instance. Note that this is an additional security layer and does not replace the need for proper authentication and security best practices. There are two predefined entries: 193.148.160.0/19 and 45.129.40.0/21. They ensure that you can access your instance from STACKIT cloud services. If you want to access your instance from the public net, you need to add the client’s IPv4 address or subnet. The entries follow the CIDR notation. If you want to allow a single IP address (e.g. single host), then set 32as the subnet parameter. For example, to allow a host with the source IPv4 address of 93.229.84.137, add 93.229.84.137/32 as an ACL entry. At the moment, you cannot add IPv6 addresses.

Do not set 0.0.0.0/0 as an ACL IP, because then your instance can be accessed from any IP.

Create an instance

To create an instance, first go to the STACKIT Portal and log in.

STACKIT CLI

Choose the flavor and storage class

First, you need to determine which plan you need. The available plans depend on the chosen version. To get a list of available plans, execute:

stackit mariadb plans

Choose the properties for your new instance

Flag	Options	Default	Optional
name	my-mariadb-instance
plan-id	See Service plans of MariaDB
version	10.6, 10.11	10.11	x
acl	IPv4 and net in CIDR notation	193.148.160.0/19 45.129.40.0/21 45.135.244.0/22 192.214.174.229/32 192.214.176.140/32	x

You can also have a look at Service plans of MariaDB to learn more about the available plans.

Execute the creation command

To create your instance, execute the following command:

stackit mariadb instance create --name <name> --plan-id <plan-id> --version <version --acl <acl>

After executing the command you, need to confirm with y.

When the instance is created successfully, the CLI will return the instance ID:

Created instance for project "Test-Projekt-28-07-2025". Instance ID: 1226c9a1-62cd-4ec1-bf42-7b15d54c00d9

Examples

Create an instance with minimum flags:

stackit mariadb instance create --name my-mariadb-instance --plan-id ddf1b3f5-c559-4869-83ad-72264655132c

STACKIT Portal

1. In the sidebar, click on MariaDB.

2. In the bar on the top, click on Create MariaDB.

   See Instance properties for a better understanding of all options.

3. After you configured everything to your needs, create your instance.

   For cost control, you can see a price estimation on the right hand site. To finally create the instance, click on Order fee-based. The system will add your newly created instance to the list of your MariaDB instances. After a few seconds, your instance state will change from Pending … to Active. Congratulations, your MariaDB instance is up and running!

Cloud Foundry CLI

1. To use the Cloud Foundry CLI you first need to login into your STACKIT project endpoint. Read Interact with Cloud Foundry to get help logging in.

2. Create the MariaDB service with the cf command:

   Parameter	Meaning	Example
   mariadb-plan	An available plan for your instance. See Service plans for MariaDB to learn about available plans.	mariadb-1.2.10-replica
   individual-service-name	The name of your service. You can freely choose anything.	my-cf-mariadb-service

   cf create-service appcloud-mariadb1011 [mariadb-plan] [individual-service-name]

   Example:

   cf create-service appcloud-mariadb1011 mariadb-1.2.10-replica my-cf-mariadb-service

   STACKIT Portal/CLI and Cloud Foundry cross-management is not possible

   Read Service isolation between STACKIT Portal/CLI and Cloud Foundry to get more information.

View an instance

STACKIT CLI

To view an instance, execute with the following parameters:

Argument	Description
INSTANCE_ID	Instance ID of the instance you want to query

stackit mariadb instance describe <INSTANCE_ID>

Example output:

ID                   │ 1226c9a1-62cd-4ec1-bf42-7b15d54c00d9
─────────────────────┼───────────────────────────────────────────────────────────────────────────────────────
NAME                 │ my-mariadb-instance
─────────────────────┼───────────────────────────────────────────────────────────────────────────────────────
LAST OPERATION TYPE  │ create
─────────────────────┼───────────────────────────────────────────────────────────────────────────────────────
LAST OPERATION STATE │ succeeded
─────────────────────┼───────────────────────────────────────────────────────────────────────────────────────
PLAN ID              │ ddf1b3f5-c559-4869-83ad-72264655132c
─────────────────────┼───────────────────────────────────────────────────────────────────────────────────────
ACL                  │ 193.148.160.0/19,45.129.40.0/21,45.135.244.0/22,192.214.174.229/32,192.214.176.140/32

STACKIT Portal

1. In the sidebar, click on MariaDB.
2. Click on the instance you’d like to view.

Cloud Foundry CLI

1. To use the Cloud Foundry CLI you first need to login into your STACKIT project endpoint. Read Interact with Cloud Foundry to get help logging in.

2. List the MariaDB services and watch details with the cf command:

   List services

   cf services | grep mariadb

   View the details of a service

   cf service [service-name]

Edit an instance

STACKIT CLI

You can edit the following properties of an instance: acl, plan and version. To get a reference to these flags, have a look at Create an instance.

The MariaDB plans affecting storage can only be upgraded.

Argument	Description
INSTANCE_ID	Instance ID of the instance you want to query

Flags	Datatype	Unit
acl	Array of strings
plan-id	String	-
plan-name	String	-
version	String	-

To edit the instance, execute the following command:

stackit mariadb instance update <INSTANCE_ID> --<Flag Name> <Flag Value>

Example

stackit mariadb instance update 8db6a0f2-2b93-43f3-be54-464ee5a9fbed --plan-id ddf1b3f5-c559-4869-83ad-72264655132c

STACKIT Portal

To edit the plan:

1. In the sidebar, click on MariaDB.
2. Click on the instance you’d like to edit.
3. On the Plan pane, click on the selected plan link next to Plan name.
4. Next to the desired plan, click on Change.
5. In the popup dialog, click on Order fee-based.
6. Wait for the database to become Active again.

To change the ACL and disk treshold:

1. In the sidebar, click on MariaDB.
2. Click on the instance you’d like to edit.
3. On the Custom parameters pane, click on Edit.
4. Make your changes and click on Save.
5. Wait for the database to become Active again.

Delete an instance

STACKIT CLI

You can delete an instance when it operates in its READY-state. After executing this command, the operation cannot be undone. To delete an instance, execute:

Argument	Description
INSTANCE_ID	Instance ID of the instance you want to query

stackit mariadb instance delete <INSTANCE_ID>

You get the following output:

Deleted instance "my-MariaDB-instance"

STACKIT Portal

You can delete an instance when it is in its Active state. You cannot undo a deletion.

1. In the sidebar, click on MariaDB.
2. On the pane of the instance you want to delete, click on the three dots icon.
3. Click on Delete.
4. Enter the name of the instance and confirm with Delete.

Cloud Foundry CLI

1. To use the Cloud Foundry CLI you first need to login into your STACKIT project endpoint. Read Interact with Cloud Foundry to get help logging in.

2. Delete a service with the cf command:

   List services

   cf delete-service [service-name]

   STACKIT Portal/CLI and Cloud Foundry cross-management is not possible

   Read Service isolation between STACKIT Portal/CLI and Cloud Foundry to get more information.