{
  "schema_version": 2,
  "id": "operate/oss_and_stack/stack-with-enterprise/deprecated-features/gears-v1/jvm/install",
  "title": "Install RedisGears and the JVM plugin",
  "url": "https://redis.io/docs/latest/operate/oss_and_stack/stack-with-enterprise/deprecated-features/gears-v1/jvm/install/",
  "summary": "",
  "aliases": [
    "/operate/oss_and_stack/stack-with-enterprise/gears-v1/jvm/install/"
  ],
  "tags": [
    "docs",
    "operate",
    "stack"
  ],
  "last_updated": "2026-10-02T14:53:57+01:00",
  "page_type": "content",
  "content_hash": "252c86fa26d948d70b6d54100af75b2e87251eadafe7cd5c3ca3c6b3e236ebe3",
  "sections": [
    {
      "id": "overview",
      "title": "Overview",
      "role": "overview",
      "text": "Before you can use RedisGears with the JVM, you need to install the RedisGears module and JVM plugin on your Redis Software cluster and enable them for a database."
    },
    {
      "id": "prerequisites",
      "title": "Prerequisites",
      "role": "content",
      "text": "1. Redis Software v6.0.12 or later\n\n1. [Created a Redis Software cluster](https://redis.io/docs/latest/operate/rs/clusters/new-cluster-setup)\n\n1. [Added nodes to the cluster](https://redis.io/docs/latest/operate/rs/clusters/add-node)\n\n1. [Installed RedisGears and the JVM plugin](https://redis.io/docs/latest/operate/oss_and_stack/stack-with-enterprise/deprecated-features/gears-v1/installing-redisgears#install-redisgears)"
    },
    {
      "id": "enable-redisgears-for-a-database",
      "title": "Enable RedisGears for a database",
      "role": "content",
      "text": "1. From the Redis Software admin console's **databases** page, select the **Add** button to create a new database:\n\n    ![The Add icon](https://redis.io/docs/latest/images/rs/icon_add.png)\n\n1. Confirm that you want to create a new Redis database with the **Next** button.\n\n1. On the **create database** page, give your database a name.\n\n1. For **Redis Modules**, select the **Add** button and choose RedisGears from the **Module** dropdown list.\n\n1. Select **Add Configuration**, enter `Plugin gears_jvm` in the box, then select the **OK** button:\n\n    ![The Save icon](https://redis.io/docs/latest/images/rs/icon_save.png)\n\n    > [!NOTE]\n    > You can configure additional JVM options in this box. For example:<br></br>\n    > `Plugin gears_jvm JvmOptions `<nobr>`'-Dproperty1=value1`</nobr> <nobr>`-Dproperty2=value2'`</nobr>\n    >     \n\n1. Select the **Activate** button."
    },
    {
      "id": "verify-the-install",
      "title": "Verify the install",
      "role": "content",
      "text": "Run the `RG.JSTATS` command from a database shard to view statistics and verify that you set up RedisGears and the JVM plugin correctly:\n\n[code example]"
    }
  ],
  "examples": [
    {
      "id": "verify-the-install-ex0",
      "language": "sh",
      "code": "$ shard-cli 3\n172.16.0.1:12345> RG.JSTATS",
      "section_id": "verify-the-install"
    }
  ]
}