Quota Management

MAX_ACTIVE_TUNNELS: z.coerce.number().int().positive().default(5)

MAX_ACTIVE_TUNNELS=10

export MAX_ACTIVE_TUNNELS=10

const activeCount = await this.repository.countActiveTunnels(input.userId);
assertWithinTunnelLimit(activeCount, this.env.MAX_ACTIVE_TUNNELS);

import { AppError } from '../lib/app-error.js';

export function assertWithinTunnelLimit(activeCount: number, maxActive: number): void {
  if (activeCount >= maxActive) {
    throw new AppError(
      409,
      'TUNNEL_LIMIT_REACHED',
      `Maximum of ${maxActive} active tunnels reached.`,
      { activeCount, maxActive },
    );
  }
}

const ACTIVE_STATES = new Set(['active', 'stopping']);

{
  "statusCode": 409,
  "code": "TUNNEL_LIMIT_REACHED",
  "message": "Maximum of 5 active tunnels reached.",
  "details": {
    "activeCount": 5,
    "maxActive": 5
  }
}

✖ Failed to create tunnel: Maximum of 5 active tunnels reached.

You currently have 5 active tunnels. Stop an existing tunnel to create a new one:

  rs-tunnel list
  rs-tunnel stop <tunnel-id>

rs-tunnel list

[
  {
    "id": "tunnel_abc123",
    "hostname": "my-app.tunnel.example.com",
    "slug": "my-app",
    "status": "active",
    "requestedPort": 3000,
    "createdAt": "2026-03-05T10:00:00Z",
    "lease": {
      "lastHeartbeatAt": "2026-03-05T10:05:00Z",
      "expiresAt": "2026-03-05T10:06:00Z"
    },
    "stoppedAt": null,
    "lastError": null
  }
]

rs-tunnel stop <tunnel-id>

rs-tunnel stop my-app.tunnel.example.com

await this.repository.createAuditLog({
  userId: user.id,
  action: 'tunnel.created',
  metadata: {
    tunnelId: dbTunnel.id,
    slug,
    hostname,
  },
});

SELECT user_id, COUNT(*) as active_count
FROM tunnels
WHERE status IN ('active', 'stopping')
GROUP BY user_id
ORDER BY active_count DESC;

metrics.increment('quota.check');
if (activeCount >= maxActive) {
  metrics.increment('quota.exceeded');
  throw new AppError(...);
}