Valkey® Admin, the Valkey project’s app for working with Valkey in a window, also comes as a web app in a Docker container. You run one command and open it in your browser.
By the end, Valkey Admin runs in Docker on your computer and is connected to your Valkey server.
Note: Every command and screen on this page is real, from Valkey Admin 1.3.0 in Docker Desktop 4.99 on an Apple silicon Mac.
Prerequisites
- Docker, running. On a Mac that’s Docker Desktop: Get Docker (opens in a new tab).
- Valkey running on your computer, on its usual port, 6379.
Step 1: Start Valkey Admin in Docker
In Terminal, run:
docker run -d --name valkey-admin -p 127.0.0.1:8091:8080 --add-host=host.docker.internal:host-gateway valkey/valkey-admin:latest
-druns it in the background, so you get your Terminal back.--name valkey-adminnames the container, so you can stop and start it by name.-p 127.0.0.1:8091:8080makes the app, which listens on port 8080 inside the container, reachable on port 8091 of your computer, and only from your computer.--add-host=host.docker.internal:host-gatewaylets the container reach your computer, and so your Valkey, by the namehost.docker.internal.valkey/valkey-admin:latestis the official image on Docker Hub (opens in a new tab).
The first time, Docker downloads the image, then prints the new container’s ID:
Unable to find image 'valkey/valkey-admin:latest' locally
latest: Pulling from valkey/valkey-admin
Digest: sha256:06acd66b82d9cd0dab5d2a5dcc829b6dc18017991b208ba0aa23a378adf1f1af
Status: Downloaded newer image for valkey/valkey-admin:latest
6fd09f933add8d1fea356cf552db64c1ee28eef730c41c031fc08a3da1d93988
Security: Keep 127.0.0.1 in the command. The web version has no sign-in, so anyone who can reach its port can use it, as Valkey Admin’s Docker guide (opens in a new tab) warns.
Step 2: Open Valkey Admin in Your Browser
Go to http://localhost:8091. Valkey Admin opens on its Connections page, empty for now.

Step 3: Connect It to Your Valkey
Click + Add Connection. Type host.docker.internal as the Host, keep port 6379, untick Use TLS and click Connect. Inside the container, localhost means the container itself, not your computer. How to Connect Valkey Admin to a Valkey Server explains every field.

Valkey Admin connects and opens the Dashboard of your server:

If the connection fails with failed to lookup address information: Name or service not known, see Fixed: failed to lookup address information: Name or service not known (Valkey Admin in Docker).
Stop and Start Valkey Admin
Stop the container when you’re done. It keeps its settings:
docker stop valkey-admin
valkey-admin
Start the same container again next time:
docker start valkey-admin
valkey-admin
Common Mistakes
| Mistake | What happens | Do this instead |
|---|---|---|
Typing localhost as the Host | Valkey Admin looks for Valkey inside its own container | Type host.docker.internal |
Publishing the port without 127.0.0.1 | Anyone who can reach that port on your computer can use Valkey Admin, which has no sign-in in its web version | Keep -p 127.0.0.1:8091:8080 |
Leaving out --add-host | On some setups, connecting to host.docker.internal fails with Name or service not known | Add the option, as in Step 1. The fix post explains why. |
FAQ
Why port 8091 and not 8080?
Valkey Admin listens on 8080 inside its container. The -p option chooses the port on your computer, and 8091 keeps 8080 free for other tools. Any free port works.
How is this different from the desktop app?
The screens are the same, and nothing is installed on your computer except the container. Valkey Admin’s documentation recommends the desktop app for watching hot keys and command logs.
Conclusion
One docker run command starts Valkey Admin at http://localhost:8091. Connect with host.docker.internal, and stop the container when you’re done.
Related
- Valkey Tutorial — Part 3: Valkey Admin for Beginners
- How to Connect Valkey Admin to a Valkey Server
- How to Install Valkey Admin on macOS
- Fixed: failed to lookup address information: Name or service not known (Valkey Admin in Docker)
Additional Resources
- Valkey Admin in Docker (opens in a new tab)
- valkey/valkey-admin on Docker Hub (opens in a new tab)
- docker run: the
--add-hostoption (opens in a new tab) - Docker Desktop networking how-tos (opens in a new tab)
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