[Self-hosted Business] "Create Snapshot" always returns empty snapshot list, even though a valid snapshot exists on Vercel

Hi all,

I’m running self-hosted Teable (Business plan, Docker deployment) and trying to enable AI Chat (Cuppy), but I’m stuck on the sandbox snapshot step. Sharing detailed findings here in case anyone has hit the same issue or a Teable team member can point me in the right direction.

The error:

“Cuppy’s environment isn’t set up yet. Please ask your admin to create a sandbox snapshot.”

Setup confirmed working:

  • LLM API via Vercel AI Gateway — active, usage confirmed in Vercel dashboard

  • AI Chat Runtime → Vercel API Token — “Configured”

  • “Test Connection” → returns “Sandbox configured successfully”

The core issue:
Despite the successful connection, infraConfigured stays false in the sandbox config response, and the “Create Snapshot” button (both in Sandbox Agent Settings and inside the Quick Setup flow) is disabled — including Back/Next buttons in the Quick Setup modal.

What makes this interesting: I manually verified via Vercel Sandbox CLI (npx sandbox create --connect --token <token>) using the exact same Team and Project configured in Teable. This succeeded, and — importantly — Vercel automatically generated a snapshot from that session afterward (visible in the Vercel dashboard under Sandboxes → Snapshots, status “Created”, Creation Method “Automatic”).

However, when I inspect Teable’s own GET .../snapshots network request (browser DevTools), it returns:

json

[]

An empty array — even though a valid snapshot clearly exists in the same project on Vercel’s side.

This strongly suggests Teable’s snapshot-listing call isn’t matching/finding snapshots that exist in the project, possibly due to how it filters by creation method, tags, or metadata that differs from an auto-generated persistence snapshot vs. one created through Teable’s own “Create Snapshot” action.

Happy to share more logs traces if useful. Thanks in advance!

Hi @Mataer_Digital,

Thanks for sharing the detailed investigation.

Your Vercel setup may be valid, but the current self-hosted Agent Runtime no longer uses Vercel Sandbox or Vercel snapshots. Therefore, snapshots created in Vercel will not be used by Teable.

Please follow the new Agent Runtime Deployment guide.

Self-hosted Agent Runtime is still at an early stage, and the deployment process will continue to evolve. If you need assistance with the setup, please contact us at support@teable.ai.

1 Like