Documentation
Redis
Connect TableR to Redis, an in-memory key-value store, with host, port, ACL user, database index, optional TLS, verifying the connection, and troubleshooting.
Redis is an in-memory key-value store. Point TableR at your Redis host and, if needed, add an ACL user, password, and database index.
Overview
TableR connects to a Redis server on port 6379 by default. Authentication is optional: older servers may need only a password, while Redis 6+ supports ACL users. A logical database index selects which numbered database you work in.
- In-memory — connect to your Redis host on port 6379.
- Auth — an optional password, plus an ACL username on Redis 6+.
- Database index — a logical database number, usually 0.
Before you start
- A reachable Redis host (host and port).
- A password, if the server requires AUTH.
- An ACL username, if the server uses Redis 6+ ACLs.
- The database index you want to work in (usually 0).
- For remote servers: network access and, usually, TLS.
Connection fields
These defaults match TableR's Redis connection form. Secrets are written to the operating system keyring, never to plain configuration files.
| Field | Required | Default | Notes |
|---|---|---|---|
| Host | Yes | 127.0.0.1 | Hostname or IP of your Redis server. |
| Port | Yes | 6379 | Redis's default port. |
| Username | No | — | Optional; a Redis 6+ ACL user. |
| Password | No | — | Optional; stored in the OS keyring. |
| Database index | No | 0 | The logical database number to select. |
| SSL/TLS | No | Off | Enable for remote servers that require TLS. |
Connect with the form
- 1Choose Redis
Open the launcher and pick the Redis card.
- 2Enter host and port
Use 127.0.0.1 and 6379 locally, or your server's endpoint.
- 3Add credentials (optional)
Add a password, and an ACL username on Redis 6+.
- 4Set the database index
Usually 0; change it to work in another logical database.
- 5Enable TLS for remote
Turn on SSL/TLS when the remote server requires it.
- 6Save and connect
Save the profile so it reappears in the launcher, then connect.
SSL/TLS
Local servers usually need no encryption. For a remote server that supports it, enable SSL/TLS so the connection and credentials are protected in transit.
- Off — no encryption (local or trusted networks only).
- On — TLS to the Redis server.
- Enable it for any remote or managed server.
Verify the connection
Once connected, open a query tab and run a couple of Redis commands:
PING
INFO serverPING should return PONG, and INFO server prints the server version and details.
Troubleshooting
| Symptom | Likely cause | Fix |
|---|---|---|
| Connection refused | Server not running, wrong host/port, or a firewall. | Confirm the server is up and 6379 is reachable; re-check host and port. |
| NOAUTH Authentication required | The server requires a password. | Add the password; it is saved to the keyring. |
| WRONGPASS invalid username-password | Wrong ACL username or password. | Re-check the credentials (Redis 6+ ACL) and update the saved password. |
| Connection reset / TLS required | The server expects a TLS connection. | Enable SSL/TLS for the connection. |