{
  "schema_version": 2,
  "id": "operate/rs/references/cli-utilities/rladmin/restart",
  "title": "rladmin restart",
  "url": "https://redis.io/docs/latest/operate/rs/references/cli-utilities/rladmin/restart/",
  "summary": "Restarts Redis Software processes for a specific database.",
  "tags": [
    "docs",
    "operate",
    "rs"
  ],
  "last_updated": "2026-01-30T12:29:26-06:00",
  "page_type": "content",
  "content_hash": "cdfe476ec976be1bf65e436373c94eb263e083933c483abb752ba2bfc2cf73b5",
  "sections": [
    {
      "id": "overview",
      "title": "Overview",
      "role": "overview",
      "text": "Schedules a restart of the Redis Software processes on primary and replica instances of a specific database.\n\n[code example]"
    },
    {
      "id": "parameters",
      "title": "Parameters",
      "role": "parameters",
      "text": "| Parameter      | Type/Value                     | Description                                                           |\n|----------------|--------------------------------|-----------------------------------------------------------------------|\n| db             | db:\\<id\\><br /> name           | Restarts Redis Software processes for the specified database                |\n| discard_data   |                                | Allows discarding data if there is no persistence or replication      |\n| force_discard  |                                | Forcibly discards data even if there is persistence or replication    |\n| preserve_roles |                                | Performs an additional failover to maintain shard roles               |"
    },
    {
      "id": "returns",
      "title": "Returns",
      "role": "returns",
      "text": "Returns `Done` if the restart completed successfully. Otherwise, it returns an error."
    },
    {
      "id": "example",
      "title": "Example",
      "role": "example",
      "text": "[code example]"
    }
  ],
  "examples": [
    {
      "id": "overview-ex0",
      "language": " sh",
      "code": "rladmin restart db { db:<id> | <name> }\n        [preserve_roles]\n        [discard_data]\n        [force_discard]",
      "section_id": "overview"
    },
    {
      "id": "example-ex0",
      "language": " sh",
      "code": "$ rladmin restart db db:5 preserve_roles\nMonitoring 1db07491-35da-4bb6-9bc1-56949f4c312a\nactive - SMUpgradeBDB init\nactive - SMUpgradeBDB stop_forwarding\nactive - SMUpgradeBDB stop_active_expire\nactive - SMUpgradeBDB check_slave\noactive - SMUpgradeBDB stop_active_expire\nactive - SMUpgradeBDB second_failover\ncompleted - SMUpgradeBDB\nDone",
      "section_id": "example"
    }
  ]
}