{
  "id": "redis-cli",
  "title": "redis-cli",
  "url": "https://redis.io/docs/latest/operate/rs/8.0/references/cli-utilities/redis-cli/",
  "summary": "Run Redis commands.",
  "content": "\nThe `redis-cli` command-line utility lets you interact with a Redis database. With `redis-cli`, you can run [Redis commands](https://redis.io/docs/latest/commands) directly from the command-line terminal or with [interactive mode](#interactive-mode).\n\nIf you want to run Redis commands without `redis-cli`, you can [connect to a database with Redis Insight](https://redis.io/docs/latest/develop/tools/insight) and use the built-in [CLI](https://redis.io/docs/latest/develop/tools/insight) prompt instead.\n\n## Install `redis-cli`\n\nWhen you install Redis Software or Redis Open Source, it also installs the `redis-cli` command-line utility.\n\nTo learn how to install Redis and `redis-cli`, see the following installation guides:\n\n- [Redis Open Source](https://redis.io/docs/latest/operate/oss_and_stack/install/install-stack/)\n\n- [Redis Software](https://redis.io/docs/latest/operate/rs/installing-upgrading/quickstarts/redis-enterprise-software-quickstart)\n\n- [Redis Software with Docker](https://redis.io/docs/latest/operate/rs/installing-upgrading/quickstarts/docker-quickstart)\n\n## Connect to a database\n\nTo run Redis commands with `redis-cli`, you need to connect to your Redis database.\n\nYou can find endpoint and port details in the **Databases** list or the database’s **Configuration** screen.\n\n### Connect remotely\n\nIf you have `redis-cli` installed on your local machine, you can use it to connect to a remote Redis database. You will need to provide the database's connection details, such as the hostname or IP address, port, and password.\n\n```sh\n$ redis-cli -h \u003cendpoint\u003e -p \u003cport\u003e -a \u003cpassword\u003e\n```\n\nYou can also provide the password with the `REDISCLI_AUTH` environment variable instead of the `-a` option:\n\n```sh\n$ export REDISCLI_AUTH=\u003cpassword\u003e\n$ redis-cli -h \u003cendpoint\u003e -p \u003cport\u003e\n```\n\n### Connect over TLS\n\nTo connect to a Redis Software or Redis Cloud database over TLS:\n\n1. Download or copy the Redis Software server (or proxy) certificates.\n\n    - For Redis Cloud, see [Download certificates](https://redis.io/docs/latest/operate/rc/security/database-security/tls-ssl#download-certificates) for detailed instructions on how to download the server certificates (`redis_ca.pem`) from the [Redis Cloud console](https://cloud.redis.io/).\n\n    - For Redis Software, copy the proxy certificate from the Cluster Manager UI (**Cluster \u003e Security \u003e Certificates \u003e Server authentication**) or from a cluster node (`/etc/opt/redislabs/proxy_cert.pem`).\n\n1. Copy the certificate to each client machine.\n\n1. If your database doesn't require client authentication, provide the Redis Software server certificate (`redis_ca.pem` for Cloud or `proxy_cert.pem` for Software) when you connect:\n\n    ```sh\n    redis-cli -h \u003cendpoint\u003e -p \u003cport\u003e --tls --cacert \u003credis_cert\u003e.pem\n    ```\n\n1. If your database requires client authentication, provide your client's private and public keys along with the Redis Software server certificate (`redis_ca.pem` for Cloud or `proxy_cert.pem` for Software) when you connect:\n\n    ```sh\n    redis-cli -h \u003cendpoint\u003e -p \u003cport\u003e --tls --cacert \u003credis_cert\u003e.pem \\\n        --cert redis_user.crt --key redis_user_private.key\n    ```\n\n### Connect with Docker\n\nIf your Redis database runs in a Docker container, you can use `docker exec` to run `redis-cli` commands:\n\n```sh\n$ docker exec -it \u003cRedis container name\u003e redis-cli -p \u003cport\u003e\n```\n\n## Basic use\n\nYou can run `redis-cli` commands directly from the command-line terminal:\n\n```sh\n$ redis-cli -h \u003cendpoint\u003e -p \u003cport\u003e \u003cRedis command\u003e\n```\n\nFor example, you can use `redis-cli` to test your database connection and store a new Redis string in the database:\n\n```sh\n$ redis-cli -h \u003cendpoint\u003e -p 12000 PING\nPONG\n$ redis-cli -h \u003cendpoint\u003e -p 12000 SET mykey \"Hello world\"\nOK\n$ redis-cli -h \u003cendpoint\u003e -p 12000 GET mykey              \n\"Hello world\"\n```\n\nFor more information, see [Command line usage](https://redis.io/docs/latest/develop/tools/cli#command-line-usage).\n\n## Interactive mode\n\nIn `redis-cli` [interactive mode](https://redis.io/docs/latest/develop/tools/cli#interactive-mode), you can:\n\n- Run any `redis-cli` command without prefacing it with `redis-cli`.\n- Enter `?` for more information about how to use the `HELP` command and [set `redis-cli` preferences](https://redis.io/docs/latest/develop/tools/cli#preferences).\n- Enter [`HELP`](https://redis.io/docs/latest/develop/tools/cli#showing-help-about-redis-commands) followed by the name of a command for more information about the command and its options.\n- Press the `Tab` key for command completion.\n- Enter `exit` or `quit` or press `Control+D` to exit interactive mode and return to the terminal prompt.\n\nThis example shows how to start interactive mode and run Redis commands:\n\n```sh\n$ redis-cli -p 12000\n127.0.0.1:12000\u003e PING\nPONG\n127.0.0.1:12000\u003e SET mykey \"Hello world\"\nOK\n127.0.0.1:12000\u003e GET mykey\n\"Hello world\"\n```\n\n## Examples\n\n### Check slowlog\n\nRun [`slowlog get`](https://redis.io/docs/latest/commands/slowlog-get) for a list of recent slow commands:\n\n```sh\nredis-cli -h \u003cendpoint\u003e -p \u003cport\u003e slowlog get \u003cnumber of entries\u003e\n```\n\n### Scan for big keys\n\nScan the database for big keys:\n\n```sh\nredis-cli -h \u003cendpoint\u003e -p \u003cport\u003e --bigkeys\n```\n\nSee [Scanning for big keys](https://redis.io/docs/latest/develop/tools/cli#scanning-for-big-keys) for more information.\n\n## More info\n\n- [Redis CLI documentation](https://redis.io/docs/latest/develop/tools/cli)\n- [Redis commands reference](https://redis.io/docs/latest/commands/)\n",
  "tags": ["docs","operate","rs","rc"],
  "last_updated": "2026-07-23T12:00:25-05:00",
  "children": []
}