
# Install Redis Stack on macOS

How to install Redis Stack on macOS

Redis Open Source

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.

There are three brew casks available.

*   `redis-stack` contains both `redis-stack-server` and `redis-stack-redisinsight` casks.
*   `redis-stack-server` provides Redis Stack server only.
*   `redis-stack-redisinsight` contains Redis Insight.

## Install using Homebrew

First, tap the Redis Stack Homebrew tap:

```bash
brew tap redis-stack/redis-stack
```

Next, run `brew install`:

```bash
brew install redis-stack
```

The `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.

### First-time Redis installation

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.

To check this, run:

```bash
echo $PATH
```

Then, 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.

Note:

Because Redis Stack is installed using a brew cask via the `brew tap` command, it will not be integrated with the `brew services` command.

### Existing Redis installation

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.

Open the file `~/.bashrc` or `~/zshrc` (depending on your shell), and add the following lines.

For Intel-based Macs:

```bash
export PATH=/usr/local/Caskroom/redis-stack-server/<VERSION>/bin:$PATH
```

For Apple silicon Macs:

```bash
export PATH=/opt/homebrew/Caskroom/redis-stack-server/<VERSION>/bin:$PATH
```

In both cases, replace `<VERSION>` with your version of Redis Stack. For example, with version 6.2.0, path is as follows:

```bash
export PATH=/opt/homebrew/Caskroom/redis-stack-server/6.2.0/bin:$PATH
```

### Start Redis Stack Server

You can now start Redis Stack Server as follows:

```bash
redis-stack-server
```

## Installing Redis after installing Redis Stack

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:

```bash
Error: The brew link step did not complete successfully
The formula built, but is not symlinked into /usr/local
Could not symlink bin/redis-benchmark
Target /usr/local/bin/redis-benchmark
already exists. You may want to remove it:
rm '/usr/local/bin/redis-benchmark'

To force the link and overwrite all conflicting files:
brew link --overwrite redis

To list all files that would be deleted:
brew link --overwrite --dry-run redis
```

In this case, you can overwrite the Redis binaries installed by Redis Stack by running:

```bash
brew link --overwrite redis
```

However, Redis Stack Server will still be installed. To uninstall Redis Stack Server, see below.

## Uninstall Redis Stack

To uninstall Redis Stack, run:

```bash
brew uninstall redis-stack-redisinsight redis-stack-server redis-stack
brew untap redis-stack/redis-stack
```

## Connect to Redis

Once Redis is running, you can test it by running `redis-cli`:

```bash
redis-cli
```

Test the connection with the `ping` command:

```bash
127.0.0.1:6379> ping
PONG
```

You can also test that your Redis server is running using [Redis Insight](../../../../../../develop/tools/insight/index.md).

## Next steps

Once you have a running Redis instance, you may want to:

*   Try the [Redis CLI tutorial](../../../../../../develop/tools/cli/index.md)
*   Connect using one of the [Redis clients](/docs/latest/develop/clients/)
*   [Install Redis "properly"](../../install-redis/index.md#install-redis-properly) for production use.

## On this page
