Skip to main content
0 reactions

How to Install Valkey Admin on macOS

Featured card titled Install Valkey Admin on macOS, The official Valkey GUI installed with one Homebrew command, with a window listing One Homebrew command, Valkey Admin 1.3.0 and Open from Applications.
Install Valkey Admin on macOS.

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

Step 1: Install Valkey Admin with Homebrew

Open Terminal and run:

TerminalBash
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:

OutputPlain text
==> 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

  1. Open Finder and click Applications.
  2. 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.

macOS dialog asking whether to open Valkey Admin.app, an app downloaded from the internet, noting that Homebrew Cask downloaded it and Apple found no malicious software, with Cancel and Open buttons.
macOS asks once before the first launch.

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.

The Valkey Admin desktop app on macOS in dark mode, on the Connections page with the message You Have No Connections and a + Add Connection button, and a sidebar with Connections, Settings, GitHub and Learn More.
Valkey Admin opens on its empty Connections page.

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

MistakeWhat happensDo this instead
Expecting Valkey Admin to include ValkeyValkey Admin is only the app, so there’s nothing to connect toInstall Valkey too: How to Install Valkey on macOS
Clicking Cancel when macOS asks about opening the appThe app doesn’t openOpen 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 (opens in a new tab).

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 (opens in a new tab) 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.

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