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 Redis instance.

General information

Instance name

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

Redis version

With the Redis version you determine which Redis version comes to play. STACKIT updates the Redis major version according to the releases of Redis with a reasonable delay for implementation. Maybe some minor versions are skipped as well. Read the Release notes for deprecation notices and announcements of new versions regularly. For safety reasons STACKIT will deprecate Redis 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 Redis 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 Plans of Redis.

Number of nodes

With the number of nodes you can determine horizontal scaling and HA. Horizontal scaling increases availability and read performance. The 1 single plan (1 node) doesn’t have 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 Redis instance 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 Redis instance 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 with changing the plan.

You can up- and downgrade the Redis plan every time. Please note, that you can not downgrade the storage size. For all possible operations you will experience a downtime.

Custom parameters

Disk threshold

Redis instances are weak against situations of full storage. To prevent this circumstances, STACKIT’s Redis 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 with 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 practice. 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 clients 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. E.g. to allow a host with the source IPv4 address of 93.229.84.137, add 93.229.84.137/32 as ACL entry. At the moment you can not add IPv6 addresses.

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

Create an instance

To create an instance you first need to login to the STACKIT portal and login.

STACKIT CLI

Choose the flavor and storage class

At 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 redis plans

Choose the properties for your new instance

Flag	Options	Default	Optional
name	my-Redis-instance
plan-id	See Plans of Redis
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 Plans of Redis to learn more about the available plans.

Execute the creation command

To create your instance execute the following command:

stackit redis 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: 1737d9b7-ad6d-4a86-807a-bae5c5f5ed71

Examples

Create an instance with minimum flags:

stackit redis instance create --name my-redis-instance --plan-id 3849f72f-99cc-4e2c-afda-700d66ef08f2

STACKIT Portal

1. On the sidebar click on Redis.

2. On the bar on the top click on Create Redis.

   See Instance Properties for a better understanding of all options.

3. After you configured everything to your needs, you 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 Redis instances. After a few seconds, your instance state changes from Pending … to Active. Congratulation, your Redis 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 Redis instance with the cf command:

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

   cf create-service appcloud-redis7 [redis-plan] [individual-service-name]

   Example:

   cf create-service appcloud-redis7 redis-1.2.10-replica my-cf-redis-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 redis instance describe <INSTANCE_ID>

Example output:

ID                   │ 1737d9b7-ad6d-4a86-807a-bae5c5f5ed71
──────────────────────┼───────────────────────────────────────────────────────────────────────────────────────
NAME                 │ my-redis-instance
──────────────────────┼───────────────────────────────────────────────────────────────────────────────────────
LAST OPERATION TYPE  │ create
──────────────────────┼───────────────────────────────────────────────────────────────────────────────────────
LAST OPERATION STATE │ succeeded
──────────────────────┼───────────────────────────────────────────────────────────────────────────────────────
PLAN ID              │ 3849f72f-99cc-4e2c-afda-700d66ef08f2
──────────────────────┼───────────────────────────────────────────────────────────────────────────────────────
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. On the sidebar click on Redis.
2. Click on the instance you 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 Redis services and watch details with the cf command:

   List services

   cf services | grep redis

   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 Redis plans which affects 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 redis instance update <INSTANCE_ID> --<Flag Name> <Flag Value>

Example

stackit redis instance update 1737d9b7-ad6d-4a86-807a-bae5c5f5ed71 --plan-id 8309378b-3f85-403a-bf42-525d07cfdf78

STACKIT Portal

To edit the plan, do:

1. On the sidebar click on Redis.
2. Click on the instance you 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. On the popup click on Order fee-based
6. Wait for the database to become Active again.

To change the acl and disk threshold, do:

1. On the sidebar click on Redis.
2. Click on the instance you 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 redis instance delete <INSTANCE_ID>

You get the following output:

Deleted instance "my-redis-instance"

STACKIT Portal

You can delete an instance when it operates in its READY-state. You cannot undo a deletion.

1. On the sidebar click on Redis.
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.