Valkey® Admin is the Valkey project’s own app for working with Valkey in a window: you see your keys, edit them, run commands and watch the server’s memory and activity. On a Mac, one Homebrew command installs it.
By the end, Valkey Admin is installed and open on your Mac, ready to connect to a Valkey server.
Note: Every command and screen on this page is real, from Valkey Admin 1.3.0 on an Apple silicon Mac with macOS 26.
Prerequisites
- macOS 12 or later, which Homebrew’s Valkey Admin package needs.
- Homebrew. If
brew --versiondoesn’t print a version in Terminal, install it from brew.sh.
Step 1: Install Valkey Admin with Homebrew
Open Terminal and run:
Terminal
brew install --cask valkey-admin
--cask tells Homebrew to install a Mac app. It puts Valkey Admin in your Applications folder.
Homebrew may print notices about other packages first. The lines for Valkey Admin end like this:
Output
==> Fetching downloads for: valkey-admin
✔︎ Cask valkey-admin (1.3.0)
==> Installing Cask valkey-admin
==> Moving App 'Valkey Admin.app' to '/Applications/Valkey Admin.app'
🍺 valkey-admin was successfully installed!
Step 2: Open Valkey Admin for the First Time
- Open Finder and click Applications.
- Double-click Valkey Admin.
macOS asks once whether you’re sure you want to open an app downloaded from the internet. Under the question, it says Apple checked the app for malicious software and found none. Click Open.
Step 3: See the Connections Page
Valkey Admin opens on its Connections page. There are no connections yet, so it shows a + Add Connection button. The sidebar holds Connections, Settings, a link to the app’s GitHub page and Learn More.
Next: Connect It to Valkey
Valkey Admin needs a running Valkey server to connect to. How to Connect Valkey Admin to a Valkey Server walks through the connection form. If Valkey isn’t on your Mac yet, start with How to Install Valkey on macOS.
Common Mistakes
| Mistake | What happens | Do this instead |
|---|---|---|
| Expecting Valkey Admin to include Valkey | Valkey Admin is only the app, so there’s nothing to connect to | Install Valkey too: How to Install Valkey on macOS |
| Clicking Cancel when macOS asks about opening the app | The app doesn’t open | Open it again from Applications and click Open |
FAQ
Is Valkey Admin free?
Yes. It’s open source under the Apache License 2.0, and its code is on GitHub.
Is there a desktop app for Windows?
Valkey Admin’s documentation offers the desktop app for macOS and Linux. It also runs as a web app in Docker: How to Run Valkey Admin in Docker.
What does the desktop app add over the web version?
Its documentation recommends the desktop app for watching hot keys and command logs: slow commands, large requests and large replies.
Conclusion
One Homebrew command installs Valkey Admin, and macOS asks once before the first launch. Next, connect it to your Valkey server.
Related
- Valkey Tutorial — Part 3: Valkey Admin for Beginners
- How to Connect Valkey Admin to a Valkey Server
- How to Run Valkey Admin in Docker
- How to Install Valkey on macOS
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.
