REDB custom resource options

A primer for the configuration options for Redis Enterprise database custom resource definitions.

The database options are specified in the spec section of the database custom resource. These options include options that you can change and options that are created by the controller for applications or developers. Changes made to the REDB custom resource will override changes made to the database via the admin console or rladmin commands.

The most common options are listed below. For a complete list of options, see Redis Enterprise Database API.


Manually sets the TCP port on which the database is available. If the port number is not specified, it will be automatically generated.

databasePort cannot be added, removed, or changed after database creation.

If the admission controller is installed and configured, it will run validity checks before the REDB creation. If the port is not available, you'll get an error for "port is unavailable." If the port is not valid, you'll get an error for "change databasePort is not allowed."


A string containing the name of a secret that contains the desired database password.

If you specify a secret name, you must create an opaque secret before you create the database resource. The operator takes the password from the password key in the secret.

To disable authentication for the database, use an empty string as a value for the password key.

If you do not specify a secret name, the operator will create a secret for you with the name constructed from the database name ( with "redb-" as a prefix.

When the database is created, the secret is updated to include the port and service name for the database, but the password does not change. If you did not create the secret, it is also updated with the generated database password.


An eviction policy (default: volatile-lru)


The amount of memory to allocate that is at least 100MB. Values are an integer suffixed with a unit. For example, values like 1GB, 250MB, etc.


The value for the database persistence setting.

The value is a keyword with the values:

Value Description
disabled Data is not persisted (default)
aofEverySecond Data is synced to disk every second
aofAlways Data is synced to disk with every write.
snapshotEvery1Hour A snapshot of the database is created every hour
snapshotEvery6Hour A snapshot of the database is created every 6 hours.
snapshotEvery12Hour A snapshot of the database is created every 12 hours.


A boolean that indicates whether the database is rack-zone aware (default: the cluster setting)


The name of the cluster to create the database on.

The value has a single name property. For example, to refer to the rec cluster:

   name: rec


The upgrade policy specific to an REDB: major or latest.

Specifying this field during REDB creation will determine if the database version is the latest available, or the latest major version available.

If it is not specified, the database will follow the upgrade policy set on the cluster. If the cluster version is set to major, only major will be accepted on REDBs. If the cluster is set to latest, both latest and major are valid for the REDB.


A boolean that indicates whether in-memory database replication is enabled (default: false).

When enabled, the database has a replica shard for every master.


The number of database shards (default: 1).


Controls SSL authentication and encryption for connections to the database.

Value Description
disabled no incoming connection to the Database uses SSL (default)
enabled all incoming connections to the Database must use SSL.
replica_ssl databases that replicate from this database must use SSL.
Back to top ↑