# X_RATE_LIMIT_TENANT_BUCKET_UNKNOWN

## Means

the tenant allowance names a bucket nothing declares

## Typical cause

`rateLimit.tenantBucket: 'tenant'` with no `rateLimit.buckets.tenant` beside it. Refused at `defineHttpConfig`, **before the socket opens**, and not on the first request: `bucketFor` resolves an unknown name to `default`, so a whole tenant's cap written as 5,000 would silently be the 120-burst `default` — looser than the declaration and visible nowhere. The cause lists every bucket name that IS declared

## Fix

declare the bucket beside the name — `configureHttp({ rateLimit: { tenantBucket: '<name>', buckets: { '<name>': { capacity: 5000, refillPerSecond: 100 } } } })` — or drop `tenantBucket` to leave this app with no per-tenant allowance

[HTTP](/error-codes#http)