Configure Weaviate tenant offloading to cold storage

domain: weaviate.io · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Enable the offload-s3 module in your Weaviate deployment by adding offload-s3 to the ENABLE_MODULES environment variable
  2. Set OFFLOAD_S3_BUCKET to the target S3 bucket name and optionally OFFLOAD_S3_BUCKET_AUTO_CREATE=true to allow automatic bucket creation
  3. Provide AWS credentials via IAM role (preferred) or AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY environment variables
  4. Set a tenant's activity status to INACTIVE (COLD) to unload it from memory, then set it to OFFLOADED to move shard data to S3 cold storage
  5. To bring the tenant back, set its status back to ACTIVE (HOT); Weaviate will download the shard from S3 before serving queries
  6. Monitor transient statuses OFFLOADING and ONLOADING — these are system-managed and not directly settable by the client

Known gotchas

Related routes

Manage Weaviate multi-tenant collection tenant states (ACTIVE, INACTIVE, OFFLOADED) to control resource consumption
docs.weaviate.io/weaviate/manage-collections/multi-tenancy · 6 steps · unrated
Perform CRUD operations on a Weaviate multi-tenant collection with correct tenant routing
docs.weaviate.io/weaviate/manage-collections/multi-tenancy · 6 steps · unrated
Set up hard multi-tenancy on Thanos Receive for isolated tenant storage
thanos.io · 6 steps · unrated

Give your agent this knowledge — and 15,600+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans