Valkey Single-Node Cache¶
Valkey 9.1.2 on Ubuntu 24.04 LTS, set up as a private, disposable cache. It listens on the instance itself with TLS, needs a password, keeps every key in memory only, and evicts older keys when it reaches its memory cap. This page covers what is on the image, the defaults it ships with and how billing works.
Launch on AWS Marketplace Getting started
What is on the image¶
- Valkey 9.1.2, built from the official release source with TLS support.
valkey-serverandvalkey-cliare in/usr/bin. - A systemd service,
valkey, that starts at boot and runs as the unprivilegedvalkeyuser. - First-boot setup that creates this instance's own TLS certificates, a random cache password and an access control list. Nothing secret is baked into the image.
- A helper client,
/opt/sushi/bin/valkey-cache-cli, that connects as the cache user without putting the password on the command line. - A walkthrough script,
/opt/sushi/docs/demo.sh, that checks the cache end to end.
Lua scripting is not built in, so EVAL is not available. The redis-server
and redis-cli names are not installed. Cluster and Sentinel are not
configured.
Defaults¶
| Setting | Default |
|---|---|
| Endpoint | rediss://127.0.0.1:6379 (TLS only, loopback only) |
| Plaintext port | Off |
| User | cache, allowed only keys that start with cache: |
| Memory cap | 1536 MiB, allkeys-lru eviction |
| Persistence | Off. A restart empties the cache. |
| Databases | One (database 0) |
The cache is not reachable from other machines until you change it, see Reach the cache from your VPC.
Recommended instance¶
t3.medium with at least 4 GiB of memory and an encrypted gp3 root volume of
at least 16 GiB. No inbound security group rules are needed: you connect with
AWS Systems Manager Session Manager.
Billing¶
You pay an hourly software fee while the instance runs, as shown in the offer terms on the listing. AWS bills EC2, EBS and data transfer separately.
Where to go next¶
- Getting started: subscribe, launch, connect and run your first commands.
- Configuration: files, the access rules, memory, network access and password rotation.
- Operations: security model, updates, logs and support.
- Troubleshooting: common errors and how to fix them.
Upstream project¶
Valkey is open source under the BSD-3-Clause license. See the Valkey documentation for commands, data types and configuration. Software Sushi packages the image; the Valkey project does not endorse or support it.