Render CLI Key Value commands show and set persistence mode
Introduced 2026-07-21 · score 0.96
HOW TO USE IT
When creating or updating a Key Value instance, pass `--persistence-mode` to set its mode; use `kv get` to inspect the instance details, including persistence mode. [CLI reference](https://render.com/docs/cli-reference)
render kv create --name <name> --region <region> --plan <plan> --persistence-mode <journal_snapshot|snapshot|off>render kv update <keyValueID|keyValueName> --persistence-mode <journal_snapshot|snapshot|off>render kv get <keyValueID|keyValueName>WHY THIS HELPS
Create or update a Key Value instance and inspect or set its persistence mode.
BEFORE THIS CHANGE
Journal + Snapshot was the behavior of all paid Key Value instances before the persistence-mode feature.
REQUIREMENTS AND LIMITATIONS
- Version: v2.22.0
- --name: Instance name; generated if omitted.
- --region: Instance region: frankfurt, ohio, oregon, singapore, or virginia.
- --plan: Instance plan: free, 256mb, 1g, 5g, 10g, 20g, or 40g; custom enterprise plan names are accepted.
- --persistence-mode: Set disk persistence to journal_snapshot, snapshot, or off. For create, omit to use the plan default. The docs do not state these values are mutually exclusive, but the option accepts one mode.
- <keyValueID|keyValueName> (required): Target Key Value ID or name for update/get. Name lookup uses the active workspace; use an ID or disambiguate duplicate names with --environment.
- Prerequisite: Use Render CLI v2.22.0 or later for the release-note change. Authenticate with `render login` or an API key; the CLI docs describe API-key authentication for automation.
- Prerequisite: Data persistence is unavailable for free Key Value instances.
FIRST-PARTY EVIDENCE
- https://github.com/render-oss/cli/releases/tag/v2.22.0
- https://render.com/docs/cli-reference
- https://github.com/render-oss/cli/blob/v2.22.0/CHANGELOG.md
- https://render.com/docs/key-value
- https://render.com/changelog/specify-disk-persistence-behavior-for-paid-key-value-instances
Check the installed version and the source before using it. Entry JSON