Valkey® Admin works with a server only after you add a connection to it. The Add Connection form has a dozen fields, but the Valkey on your own computer needs only a few of them.
By the end, Valkey Admin is connected to your Valkey and shows its Dashboard.
Note: Every command and screen on this page is real, from Valkey Admin 1.3.0 connected to Valkey 9.1 on an Apple silicon Mac with macOS 26.
Prerequisites
- Valkey running on your computer, on port 6379.
- Valkey Admin open: the desktop app or the web version in Docker.
Step 1: Open the Add Connection Form
Open Valkey Admin (the desktop app or the Docker version) and click + Add Connection on the Connections page. The form opens with these defaults:

- Endpoint Type: Node for a single server. Discovery is for a cluster, where Valkey Admin finds the other nodes itself.
- Alias: a name for the connection.
- Host and Port: where the server is. Valkey’s usual port is 6379.
- Auth Type, Username and Password: for a server that asks for a password. Leave them empty for a local Valkey without one. AWS IAM and GCP IAM are for Valkey on those clouds.
- Database: the numbered database to open, 0 by default.
- Use TLS and Verify TLS Certificate: for servers that encrypt their connections. Both start ticked.
Step 2: Fill In the Fields for Your Valkey
- Alias:
Local Valkey. - Host:
localhostin the desktop app. In the Docker version,host.docker.internal, becauselocalhostinside the container is the container itself. - Port: leave
6379. - Untick Use TLS: the Valkey on your computer doesn’t use TLS. Valkey Admin then warns that the connection won’t be encrypted, which is expected here.

Step 3: Connect
Click Connect. Valkey Admin opens the Dashboard of the server, named after its host, port and database: localhost-6379-db0.

Common Mistakes
| Mistake | What happens | Do this instead |
|---|---|---|
Typing localhost in the Docker version | Valkey Admin looks for Valkey inside its own container | Type host.docker.internal |
Planning to switch databases later with SELECT | Send Command blocks SELECT | Set Database in this form |
Troubleshooting
| Problem | Cause | Fix |
|---|---|---|
failed to lookup address information: Name or service not known | The Docker container can’t find host.docker.internal | Fixed: failed to lookup address information: Name or service not known (Valkey Admin in Docker) |
FAQ
Can I connect to more than one server?
Yes. Add one connection for each server.
Does Valkey Admin remember my password?
Not in the web version: its known limitations (opens in a new tab) say it asks for the password again after a page reload or in a new tab.
Conclusion
For the Valkey on your computer, type the host, keep port 6379, untick Use TLS and click Connect. Use localhost in the desktop app and host.docker.internal in Docker.
Related
- Valkey Tutorial — Part 3: Valkey Admin for Beginners
- How to Browse and Edit Keys in Valkey Admin
- How to Run Valkey Commands in Valkey Admin
- How to Read the Valkey Admin Dashboard
Additional Resources
Valkey® is a registered trademark of LF Projects, LLC. Redis® is a registered trademark of Redis Ltd. Any rights therein are reserved to Redis Ltd. Other names mentioned are trademarks of their respective owners. JD Bots isn’t affiliated with the Valkey project, LF Projects or Redis Ltd., and isn’t endorsed, supported or certified by them.
0 comments