{
  "schema_version": 2,
  "id": "operate/oss_and_stack/install/archive/install-redis/install-redis-on-mac-os",
  "title": "Install Redis on macOS",
  "url": "https://redis.io/docs/latest/operate/oss_and_stack/install/archive/install-redis/install-redis-on-mac-os/",
  "summary": "Use Homebrew to install and start Redis on macOS",
  "aliases": [
    "/operate/oss_and_stack/install/install-redis/install-redis-on-mac-os",
    "/getting-started/installation/install-redis-on-mac-os/"
  ],
  "tags": [
    "docs",
    "operate",
    "stack",
    "oss"
  ],
  "last_updated": "2026-09-30T13:16:11-07:00",
  "page_type": "content",
  "content_hash": "456630d6bd5c3f22b7f9606caea57897f6ca173b50ef859adcfefecdc1129b9f",
  "sections": [
    {
      "id": "overview",
      "title": "Overview",
      "role": "overview",
      "text": "This guide shows you how to install Redis on macOS using Homebrew. Homebrew is the easiest way to install Redis on macOS. If you'd prefer to build Redis from the source files on macOS, see [Installing Redis from Source](https://redis.io/docs/latest/operate/oss_and_stack/install/archive/install-redis/install-redis-from-source).\n\n> [!NOTE]\n> The Homebrew distribution of Redis Open Source is only supported on macOS."
    },
    {
      "id": "prerequisites",
      "title": "Prerequisites",
      "role": "content",
      "text": "First, make sure you have Homebrew installed. From the terminal, run:\n\n\nbrew --version\n\n\nIf this command fails, you'll need to [follow the Homebrew installation instructions](https://brew.sh/)."
    },
    {
      "id": "installation",
      "title": "Installation",
      "role": "setup",
      "text": "From the terminal, run:\n\n\nbrew install redis\n\n\nThis will install Redis on your system."
    },
    {
      "id": "starting-and-stopping-redis-in-the-foreground",
      "title": "Starting and stopping Redis in the foreground",
      "role": "content",
      "text": "To test your Redis installation, you can run the `redis-server` executable from the command line:\n\n\nredis-server\n\n\nIf successful, you'll see the startup logs for Redis, and Redis will be running in the foreground.\n\nTo stop Redis, enter `Ctrl-C`."
    },
    {
      "id": "starting-and-stopping-redis-using-launchd",
      "title": "Starting and stopping Redis using launchd",
      "role": "content",
      "text": "As an alternative to running Redis in the foreground, you can also use `launchd` to start the process in the background:\n\n\nbrew services start redis\n\n\nThis launches Redis and restarts it at login. You can check the status of a `launchd` managed Redis by running the following:\n\n\nbrew services info redis\n\n\nIf the service is running, you'll see output like the following:\n\n\nredis (homebrew.mxcl.redis)\nRunning: ✔\nLoaded: ✔\nUser: miranda\nPID: 67975\n\n\nTo stop the service, run:\n\n\nbrew services stop redis"
    },
    {
      "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](https://redis.io/docs/latest/develop/tools/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](https://redis.io/docs/latest/develop/tools/cli)\n* Connect using one of the [Redis clients](https://redis.io/docs/latest/develop/clients)\n* [Install Redis \"properly\"](https://redis.io/docs/latest/operate/oss_and_stack/install/archive/install-redis#install-redis-properly)\n  for production use."
    }
  ],
  "examples": []
}