AWS: Resize, upgrade and delete
Configuration → Instance settings → Data size, then Apply changes.

Resize
Configuration → Instance settings → Data size, then Apply changes.
Resizing moves your instance to a machine with the new memory allocation. Your data, endpoint, credentials and network rules all stay as they are.
The instance is briefly unavailable while compute is replaced. Plan it like a deployment rather than a background task.
Sizes can go up or down, within the limits of your tier.
Change throughput
Throughput in the same panel switches between Standard and High. High gives you twice the CPU cores at the same memory, and the larger machine's network bandwidth. It follows the same brief-interruption pattern as a resize. Instances keep the machines and the price they were created with, so one created on an earlier rate card switches between that card's Standard and High machines.
Upgrade the engine
Version in Instance settings lists the versions available to you. Choosing a newer one and applying restarts the instance on that build, replicas first.
We support the latest patch of the current minor release, and of the previous one for 6 months after a new minor ships, and we move databases on an older patch to the latest in their maintenance window. See Engine versions and upgrades.
Downgrades are not supported. Take a snapshot before a minor upgrade if you may need the old data back.
Enable Lua or TLS
Both change which build of the engine runs, so both restart the instance. Enable them from Instance settings and apply.
Lua cannot be turned off once enabled — create a new instance without it if you need to.
Encrypt replication
With TLS on, a Pro database can also encrypt the replication stream between its
nodes: turn on Encrypted replication on the Configuration tab, next to
TLS, or send replication_tls: true to POST /instances/{id}/binary. Replicas
then copy from the primary over TLS on port 6380, with the database's own
certificate, instead of in plaintext inside the cloud network. Turning it on or
off restarts every node once. A new replica added later does its first sync
over TLS too.
It is off by default because it costs some CPU on each node: about a third more for the replication work in our measurements, with no measurable change in replication lag or in how long a full resync takes. A sharded database with TLS always encrypts traffic between its nodes, so there is nothing to turn on.
Client certificates (mutual TLS)
With TLS on, a database can ask TLS clients for a certificate signed by your own certificate authority. On the Configuration tab, under Client certificates, paste your CA certificate (PEM, CA certificates only, never a private key) and choose a mode:
- Optional: a client that presents a certificate must present one signed by your CA; a client that presents none is still let in.
- Required: a TLS client without such a certificate is refused. This needs Require TLS on (Network rules), because the plaintext port never asks for a certificate; KiviDB refuses the change otherwise, and refuses turning Require TLS off while certificates are required.
The certificate is checked in addition to the password, not instead of it:
clients still sign in as a database user. Applying a change restarts every node
once, and replicas added later get the same setting before they accept TLS
connections. Through the API, send client_cert_mode (off, optional,
required) and client_ca_pem to POST /instances/{id}/binary. Not available
for sharded databases yet.
Stop and start
Stop from the instance actions. Compute stops being charged; storage continues, because your data is still there. Start brings it back with everything as it was.
Use this for instances you do not need continuously. Stopping and starting are done from the console or the API; schedules run database commands, not these.
Tags
Tags are key/value labels you put on a database to find and group it: a team, an environment, a cost centre. They change nothing about how the database runs.
- Set them at creation (the Tags rows under the instance name, or
tagsinPOST /instances), and change them later from the Tags card on the database's overview or withPUT /instances/{id}/tags, whose body{"tags": {...}}replaces every tag ({"tags": {}}removes them all). - Up to 50 per database. Keys are 1-64 characters of lowercase letters, digits
and
_ . : / -, starting with a letter or digit; keys startingkividb:are reserved. Values are up to 256 characters, any text but control characters, and keep their case. - The database list shows them and filters by them: type
env=prodfor that exact value, orteamfor any database with ateamtag; several terms, separated by spaces, must all match. The API takes the same filter,GET /instances?tag=env=prod&tag=team, and returnstagson every database. - Tags are metadata: the viewer role sees them, and changing them is in the
organization's audit log, when it is turned on (
database.tags_change).
Maintenance window
Every database has a weekly maintenance window: a day, a start hour and a time
zone, 4 hours long. Until you choose one it is Sunday 03:00 UTC. Set it on the
database's Configuration tab, or with the API
(PATCH /instances/{id}/maintenance-window with day 0-6 from Sunday, hour
0-23 and an IANA timezone) or the MCP set_maintenance_window tool.
Maintenance KiviDB starts itself happens only inside the window, and the
organization's owners are emailed at least 48 hours before it. Today that is
renewing the TLS certificate of a database with TLS on, about once a year: every node restarts once,
at the same time, and the database refuses connections for a few seconds. The
Configuration tab and GET /instances/{id}/maintenance show any maintenance
already planned. Changing the window moves planned maintenance to the new one,
with a new notice.
Some things never wait for the window:
- changes you ask for, such as resizing, an engine upgrade or turning TLS on;
- failover and recovery of a node that has failed;
- a certificate within 3 days of expiry, renewed at once as emergency maintenance, with an email afterwards;
- interruptions by the cloud provider itself, such as a reclaimed Spot replica.
Delete
Danger Zone → Delete instance.
Deletion is permanent. The instance, its data and its disk are destroyed, and nothing can be recovered afterwards except from a snapshot you already took.
You will be asked to type the instance name to confirm. You can also take a final snapshot as part of the deletion — worth doing unless you are certain.
Deleting an instance also removes its private connectivity resources and stops all charges for it.
What deletion does not remove
If you created a VPC endpoint in your own AWS account for private connectivity, that belongs to your account and is not deleted with the instance. Remove it yourself once the instance is gone:
aws ec2 delete-vpc-endpoints --region <region> --vpc-endpoint-ids <vpce-id>
Snapshots and KDB exports also survive deletion, and continue to be charged for storage until you remove them from the Snapshots page.