{
  "id": "mac-os",
  "title": "Install Redis Stack on macOS",
  "url": "https://redis.io/docs/latest/operate/oss_and_stack/install/archive/install-stack/mac-os/",
  "summary": "How to install Redis Stack on macOS",
  "tags": [
    "docs",
    "operate",
    "stack",
    "oss"
  ],
  "last_updated": "2026-04-01T08:10:08-05:00",
  "page_type": "content",
  "content_hash": "d75739c9eebd08a3d7b904f53ce282b954084a6125a24cd18d3c08c0b0163bcd",
  "sections": [
    {
      "id": "overview",
      "title": "Overview",
      "role": "overview",
      "text": "To install Redis Stack on macOS, use [Homebrew](https://brew.sh/). Make sure that you have [Homebrew installed](https://docs.brew.sh/Installation) before starting on the installation instructions below.\n\nThere are three brew casks available.\n\n* `redis-stack` contains both `redis-stack-server` and `redis-stack-redisinsight` casks. \n* `redis-stack-server` provides Redis Stack server only.\n* `redis-stack-redisinsight` contains Redis Insight."
    },
    {
      "id": "install-using-homebrew",
      "title": "Install using Homebrew",
      "role": "setup",
      "text": "First, tap the Redis Stack Homebrew tap:\n\n\nbrew tap redis-stack/redis-stack\n\n\nNext, run `brew install`:\n\n\nbrew install redis-stack\n\n\nThe `redis-stack-server` cask will install all Redis and Redis Stack binaries. How you run these binaries depends on whether you already have Redis installed on your system."
    },
    {
      "id": "first-time-redis-installation",
      "title": "First-time Redis installation",
      "role": "content",
      "text": "If this is the first time you've installed Redis on your system, you need to be sure that your `PATH` variable includes the Redis Stack installation location. This location is either `/opt/homebrew/bin` for Apple silicon Macs or `/usr/local/bin` for Intel-based Macs.\n\nTo check this, run:\n\n\necho $PATH\n\n\nThen, confirm that the output contains `/opt/homebrew/bin` (Apple silicon Macs) or `/usr/local/bin` (Intel Mac). If these directories are not in the output, see the \"Existing Redis installation\" instructions below.\n\n\nBecause Redis Stack is installed using a brew cask via the `brew tap` command, it will not be integrated with the `brew services` command."
    },
    {
      "id": "existing-redis-installation",
      "title": "Existing Redis installation",
      "role": "content",
      "text": "If you have an existing Redis installation on your system, then might want to modify your `$PATH` to ensure that you're using the latest Redis Stack binaries.\n\nOpen the file `~/.bashrc` or `~/zshrc` (depending on your shell), and add the following lines.\n\nFor Intel-based Macs:\n\n\nexport PATH=/usr/local/Caskroom/redis-stack-server/<VERSION>/bin:$PATH\n\n\nFor Apple silicon Macs:\n\n\nexport PATH=/opt/homebrew/Caskroom/redis-stack-server/<VERSION>/bin:$PATH\n\n\nIn both cases, replace `<VERSION>` with your version of Redis Stack. For example, with version 6.2.0, path is as follows:\n\n\nexport PATH=/opt/homebrew/Caskroom/redis-stack-server/6.2.0/bin:$PATH"
    },
    {
      "id": "start-redis-stack-server",
      "title": "Start Redis Stack Server",
      "role": "content",
      "text": "You can now start Redis Stack Server as follows:\n\n\nredis-stack-server"
    },
    {
      "id": "installing-redis-after-installing-redis-stack",
      "title": "Installing Redis after installing Redis Stack",
      "role": "setup",
      "text": "If you've already installed Redis Stack with Homebrew and then try to install Redis with `brew install redis`, you may encounter errors like the following:\n\n\nError: The brew link step did not complete successfully\nThe formula built, but is not symlinked into /usr/local\nCould not symlink bin/redis-benchmark\nTarget /usr/local/bin/redis-benchmark\nalready exists. You may want to remove it:\nrm '/usr/local/bin/redis-benchmark'\n\nTo force the link and overwrite all conflicting files:\nbrew link --overwrite redis\n\nTo list all files that would be deleted:\nbrew link --overwrite --dry-run redis\n\n\nIn this case, you can overwrite the Redis binaries installed by Redis Stack by running:\n\n\nbrew link --overwrite redis\n\n\nHowever, Redis Stack Server will still be installed. To uninstall Redis Stack Server, see below."
    },
    {
      "id": "uninstall-redis-stack",
      "title": "Uninstall Redis Stack",
      "role": "content",
      "text": "To uninstall Redis Stack, run:\n\n\nbrew uninstall redis-stack-redisinsight redis-stack-server redis-stack\nbrew untap redis-stack/redis-stack"
    },
    {
      "id": "connect-to-redis",
      "title": "Connect to Redis",
      "role": "content",
      "text": "Once Redis is running, you can test it by running `redis-cli`:\n\n\nredis-cli\n\n\nTest the connection with the `ping` command:\n\n\n127.0.0.1:6379> ping\nPONG\n\n\nYou can also test that your Redis server is running using\n[Redis Insight]()."
    },
    {
      "id": "next-steps",
      "title": "Next steps",
      "role": "content",
      "text": "Once you have a running Redis instance, you may want to:\n\n* Try the [Redis CLI tutorial]()\n* Connect using one of the [Redis clients]()\n* [Install Redis \"properly\"]()\n  for production use."
    }
  ],
  "examples": []
}