{
  "schema_version": 2,
  "id": "develop/reference/errors/common",
  "title": "Common Redis errors",
  "url": "https://redis.io/docs/latest/develop/reference/errors/common/",
  "summary": "The Redis errors you're most likely to see, with an example and how to fix each one",
  "tags": [
    "docs",
    "develop",
    "stack",
    "oss",
    "rs",
    "rc",
    "oss",
    "kubernetes",
    "clients"
  ],
  "last_updated": "2026-11-02T15:10:28+01:00",
  "children": [
    {
      "id": "develop/reference/errors/common/err-unknown-command",
      "summary": "The server doesn't recognize the command name.",
      "title": "ERR unknown command",
      "url": "https://redis.io/docs/latest/develop/reference/errors/common/err-unknown-command/"
    },
    {
      "id": "develop/reference/errors/common/err-wrong-number-of-arguments",
      "summary": "A command has too many or too few arguments.",
      "title": "ERR wrong number of arguments",
      "url": "https://redis.io/docs/latest/develop/reference/errors/common/err-wrong-number-of-arguments/"
    },
    {
      "id": "develop/reference/errors/common/err-syntax-error",
      "summary": "A command's options are misspelled, in the wrong place, or can't be used together.",
      "title": "ERR syntax error",
      "url": "https://redis.io/docs/latest/develop/reference/errors/common/err-syntax-error/"
    },
    {
      "id": "develop/reference/errors/common/err-not-an-integer",
      "summary": "A command requires a whole number, but the stored value or an argument is not a whole number.",
      "title": "ERR value is not an integer or out of range",
      "url": "https://redis.io/docs/latest/develop/reference/errors/common/err-not-an-integer/"
    },
    {
      "id": "develop/reference/errors/common/wrongtype",
      "summary": "A command was used on a key that holds a different data type.",
      "title": "WRONGTYPE error",
      "url": "https://redis.io/docs/latest/develop/reference/errors/common/wrongtype/"
    },
    {
      "id": "develop/reference/errors/common/execabort",
      "summary": "A transaction was discarded because one of its commands had an error.",
      "title": "EXECABORT error",
      "url": "https://redis.io/docs/latest/develop/reference/errors/common/execabort/"
    },
    {
      "id": "develop/reference/errors/common/noscript",
      "summary": "EVALSHA asked for a script that isn't in the server's script cache.",
      "title": "NOSCRIPT error",
      "url": "https://redis.io/docs/latest/develop/reference/errors/common/noscript/"
    },
    {
      "id": "develop/reference/errors/common/busykey",
      "summary": "RESTORE tried to create a key that already exists.",
      "title": "BUSYKEY error",
      "url": "https://redis.io/docs/latest/develop/reference/errors/common/busykey/"
    },
    {
      "id": "develop/reference/errors/common/moved",
      "summary": "The key belongs to a hash slot that another cluster node serves.",
      "title": "MOVED error",
      "url": "https://redis.io/docs/latest/develop/reference/errors/common/moved/"
    },
    {
      "id": "develop/reference/errors/common/ask",
      "summary": "The key's hash slot is moving to another cluster node, and the key may already be there.",
      "title": "ASK error",
      "url": "https://redis.io/docs/latest/develop/reference/errors/common/ask/"
    },
    {
      "id": "develop/reference/errors/common/crossslot",
      "summary": "A command used keys that belong to different hash slots.",
      "title": "CROSSSLOT error",
      "url": "https://redis.io/docs/latest/develop/reference/errors/common/crossslot/"
    },
    {
      "id": "develop/reference/errors/common/tryagain",
      "summary": "A command accessed multiple keys while their hash slot was being migrated between cluster nodes.",
      "title": "TRYAGAIN error",
      "url": "https://redis.io/docs/latest/develop/reference/errors/common/tryagain/"
    },
    {
      "id": "develop/reference/errors/common/clusterdown",
      "summary": "The cluster can't serve the command because a hash slot has no working node.",
      "title": "CLUSTERDOWN error",
      "url": "https://redis.io/docs/latest/develop/reference/errors/common/clusterdown/"
    },
    {
      "id": "develop/reference/errors/common/oom",
      "summary": "Redis has reached its memory limit and can't make room for new data.",
      "title": "OOM error",
      "url": "https://redis.io/docs/latest/develop/reference/errors/common/oom/"
    },
    {
      "id": "develop/reference/errors/common/misconf",
      "summary": "Redis stopped accepting writes because it couldn't save your data to disk.",
      "title": "MISCONF error",
      "url": "https://redis.io/docs/latest/develop/reference/errors/common/misconf/"
    },
    {
      "id": "develop/reference/errors/common/err-max-clients",
      "summary": "The server already has as many connections as its limit allows.",
      "title": "ERR max number of clients reached",
      "url": "https://redis.io/docs/latest/develop/reference/errors/common/err-max-clients/"
    },
    {
      "id": "develop/reference/errors/common/noauth",
      "summary": "The server requires a password, and the connection hasn't authenticated.",
      "title": "NOAUTH error",
      "url": "https://redis.io/docs/latest/develop/reference/errors/common/noauth/"
    },
    {
      "id": "develop/reference/errors/common/wrongpass",
      "summary": "The username or password is wrong, or the user is disabled.",
      "title": "WRONGPASS error",
      "url": "https://redis.io/docs/latest/develop/reference/errors/common/wrongpass/"
    },
    {
      "id": "develop/reference/errors/common/noperm",
      "summary": "The user is authenticated but isn't allowed to run the command or use the key.",
      "title": "NOPERM error",
      "url": "https://redis.io/docs/latest/develop/reference/errors/common/noperm/"
    },
    {
      "id": "develop/reference/errors/common/denied",
      "summary": "Protected mode refused a connection from another computer, because the server has no password.",
      "title": "DENIED error",
      "url": "https://redis.io/docs/latest/develop/reference/errors/common/denied/"
    },
    {
      "id": "develop/reference/errors/common/readonly",
      "summary": "A command that changes data was sent to a read-only replica.",
      "title": "READONLY error",
      "url": "https://redis.io/docs/latest/develop/reference/errors/common/readonly/"
    },
    {
      "id": "develop/reference/errors/common/masterdown",
      "summary": "A replica lost its link to its primary and is set not to serve data that may be out of date.",
      "title": "MASTERDOWN error",
      "url": "https://redis.io/docs/latest/develop/reference/errors/common/masterdown/"
    },
    {
      "id": "develop/reference/errors/common/noreplicas",
      "summary": "The primary accepts writes only when enough replicas are connected, and there aren't enough.",
      "title": "NOREPLICAS error",
      "url": "https://redis.io/docs/latest/develop/reference/errors/common/noreplicas/"
    },
    {
      "id": "develop/reference/errors/common/loading",
      "summary": "Redis is still loading its data into memory and can't serve the command yet.",
      "title": "LOADING error",
      "url": "https://redis.io/docs/latest/develop/reference/errors/common/loading/"
    },
    {
      "id": "develop/reference/errors/common/busy",
      "summary": "A Lua script or function has run for too long, and Redis is blocked until it ends.",
      "title": "BUSY error",
      "url": "https://redis.io/docs/latest/develop/reference/errors/common/busy/"
    },
    {
      "id": "develop/reference/errors/common/nogroup",
      "summary": "A stream command named a consumer group or stream that doesn't exist.",
      "title": "NOGROUP error",
      "url": "https://redis.io/docs/latest/develop/reference/errors/common/nogroup/"
    },
    {
      "id": "develop/reference/errors/common/busygroup",
      "summary": "XGROUP CREATE tried to create a consumer group that already exists.",
      "title": "BUSYGROUP error",
      "url": "https://redis.io/docs/latest/develop/reference/errors/common/busygroup/"
    }
  ],
  "page_type": "content",
  "content_hash": "bc1147e9bcdbc6a454b444111abacbbc6e95a419b0a2de07d25fb5922a629a44",
  "sections": [
    {
      "id": "overview",
      "title": "Overview",
      "role": "overview",
      "text": "These pages explain the Redis errors you're most likely to see. Each one shows what the error means, an example, and how to fix it. To find an error that isn't here, see the [list of all error messages](https://redis.io/docs/latest/develop/reference/errors/all)."
    },
    {
      "id": "command-errors",
      "title": "Command errors",
      "role": "syntax",
      "text": "- [`ERR unknown command`](https://redis.io/docs/latest/develop/reference/errors/common/err-unknown-command): The server doesn't recognize the command name.\n- [`ERR wrong number of arguments`](https://redis.io/docs/latest/develop/reference/errors/common/err-wrong-number-of-arguments): A command has too many or too few arguments.\n- [`ERR syntax error`](https://redis.io/docs/latest/develop/reference/errors/common/err-syntax-error): A command's options are misspelled, in the wrong place, or can't be used together.\n- [`ERR value is not an integer or out of range`](https://redis.io/docs/latest/develop/reference/errors/common/err-not-an-integer): A command requires a whole number, but the stored value or an argument is not a whole number.\n- [`WRONGTYPE`](https://redis.io/docs/latest/develop/reference/errors/common/wrongtype): A command was used on a key that holds a different data type.\n- [`EXECABORT`](https://redis.io/docs/latest/develop/reference/errors/common/execabort): A transaction was discarded because one of its commands had an error.\n- [`NOSCRIPT`](https://redis.io/docs/latest/develop/reference/errors/common/noscript): `EVALSHA` asked for a script that isn't in the server's script cache.\n- [`BUSYKEY`](https://redis.io/docs/latest/develop/reference/errors/common/busykey): `RESTORE` tried to create a key that already exists."
    },
    {
      "id": "cluster-errors",
      "title": "Cluster errors",
      "role": "content",
      "text": "- [`MOVED`](https://redis.io/docs/latest/develop/reference/errors/common/moved): The key belongs to a hash slot that another cluster node serves.\n- [`ASK`](https://redis.io/docs/latest/develop/reference/errors/common/ask): The key's hash slot is moving to another cluster node, and the key may already be there.\n- [`CROSSSLOT`](https://redis.io/docs/latest/develop/reference/errors/common/crossslot): A command used keys that belong to different hash slots.\n- [`TRYAGAIN`](https://redis.io/docs/latest/develop/reference/errors/common/tryagain): A command accessed multiple keys while their hash slot was being migrated between cluster nodes.\n- [`CLUSTERDOWN`](https://redis.io/docs/latest/develop/reference/errors/common/clusterdown): The cluster can't serve the command because a hash slot has no working node."
    },
    {
      "id": "memory-and-persistence-errors",
      "title": "Memory and persistence errors",
      "role": "content",
      "text": "- [`OOM`](https://redis.io/docs/latest/develop/reference/errors/common/oom): Redis has reached its memory limit and can't make room for new data.\n- [`MISCONF`](https://redis.io/docs/latest/develop/reference/errors/common/misconf): Redis stopped accepting writes because it couldn't save your data to disk."
    },
    {
      "id": "connection-and-security-errors",
      "title": "Connection and security errors",
      "role": "content",
      "text": "- [`ERR max number of clients reached`](https://redis.io/docs/latest/develop/reference/errors/common/err-max-clients): The server already has as many connections as its limit allows.\n- [`NOAUTH`](https://redis.io/docs/latest/develop/reference/errors/common/noauth): The server requires a password, and the connection hasn't authenticated.\n- [`WRONGPASS`](https://redis.io/docs/latest/develop/reference/errors/common/wrongpass): The username or password is wrong, or the user is disabled.\n- [`NOPERM`](https://redis.io/docs/latest/develop/reference/errors/common/noperm): The user is authenticated but isn't allowed to run the command or use the key.\n- [`DENIED`](https://redis.io/docs/latest/develop/reference/errors/common/denied): Protected mode refused a connection from another computer, because the server has no password."
    },
    {
      "id": "replication-and-server-state-errors",
      "title": "Replication and server state errors",
      "role": "content",
      "text": "- [`READONLY`](https://redis.io/docs/latest/develop/reference/errors/common/readonly): A command that changes data was sent to a read-only replica.\n- [`MASTERDOWN`](https://redis.io/docs/latest/develop/reference/errors/common/masterdown): A replica lost its link to its primary and is set not to serve data that may be out of date.\n- [`NOREPLICAS`](https://redis.io/docs/latest/develop/reference/errors/common/noreplicas): The primary accepts writes only when enough replicas are connected, and there aren't enough.\n- [`LOADING`](https://redis.io/docs/latest/develop/reference/errors/common/loading): Redis is still loading its data into memory and can't serve the command yet.\n- [`BUSY`](https://redis.io/docs/latest/develop/reference/errors/common/busy): A Lua script or function has run for too long, and Redis is blocked until it ends."
    },
    {
      "id": "stream-errors",
      "title": "Stream errors",
      "role": "content",
      "text": "- [`NOGROUP`](https://redis.io/docs/latest/develop/reference/errors/common/nogroup): A stream command named a consumer group or stream that doesn't exist.\n- [`BUSYGROUP`](https://redis.io/docs/latest/develop/reference/errors/common/busygroup): `XGROUP CREATE` tried to create a consumer group that already exists."
    }
  ],
  "examples": []
}