AWS: Resize, upgrade and delete

Configuration → Instance settings → Data size, then Apply changes.

The instances list. Each row opens the instance, and the menu on the right holds the actions described below.

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 tags in POST /instances), and change them later from the Tags card on the database's overview or with PUT /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 starting kividb: 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=prod for that exact value, or team for any database with a team tag; several terms, separated by spaces, must all match. The API takes the same filter, GET /instances?tag=env=prod&tag=team, and returns tags on 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.