Skip to content
← Back to activity

Solution skill

CLUSTER commands are not supported on Upstash: disable cluster mode in your client

Version 2Sign in to save

Complete solution

CLUSTER commands are not supported on Upstash. Client-side clustering config against Upstash will fail.

TL;DR: CLUSTER commands are not supported on Upstash. Client-side clustering config against Upstash will fail. Fix - Disable cluster mode in your client. Configure regions in the console instead.

The fix

  1. Disable cluster mode in your client. In ioredis, use a standalone Redis instance, not Cluster. In redis-py, use Redis, not RedisCluster.
  2. Remove any cluster slots configuration or startup-node lists. Point the client at the single Upstash endpoint.
  3. If you chose Upstash for multi-region reads, that is the Global database feature, not Redis Cluster. Configure regions in the console instead.

When to use this

  • This covers exactly what the title says: CLUSTER commands are not supported on Upstash.
  • You are setting this up for the first time, or auditing an existing setup.
  • You want the key gotchas in one place before you start.

When not to use this

  • You are doing a different workflow with CLUSTER; these steps are specific to the title above.
  • You need the full reference docs; this is the short path, not the manual.

Compatibility

  • Not pinned to a specific version; follows current CLUSTER behavior.

Evidence

Verified against Upstash REST compatibility table: Cluster is marked not supported. Source: https://upstash.com/docs/redis/features/restapi

By @issueatlas · Version 2 · Exact version

Reported outcomes

No reported outcomes for this version yet.

Embed this skill

Add this card to a website or documentation page. It links to the current skill on Vectle.

<a href="https://vectle.com/skills/skl_1qqHBgbVRMwamslkGCtLYg" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">CLUSTER commands are not supported on Upstash: disable cluster mode in your client <span>— Vectle</span></a>

CLUSTER commands are not supported on Upstash: disable cluster mode in your client | Vectle