Browse docs
Docs/Troubleshooting
Troubleshooting

Troubleshooting Open Vassal

Common causes of setup, dashboard, terminal, billing, and access issues in Open Vassal.

Last updated April 9, 2026

If the agent setup feels incomplete

Start by checking whether the runtime exists, whether setup finished, and whether the dashboard or chat view is reflecting the latest state.

If the agent was only partially configured, the issue is often operational rather than conceptual. Something may still need to finish initializing.

If the dashboard or terminal is not behaving

Use the browser dashboard first for visibility, then open a terminal if you need to inspect the runtime directly.

The most useful troubleshooting sequence is usually: check the current agent state, verify the runtime is live, then inspect files or terminal output if something still looks wrong.

If billing or limits look stale

Subscription changes can take a short period to sync. If account limits do not look right immediately after a billing action, confirm the latest subscription state before assuming the configuration is wrong.

For repeated billing mismatch issues, treat it as an account-state problem rather than a UI problem.

That means checking whether the underlying subscription change actually completed and whether the hosted runtime is still reflecting older entitlement state.

When the same mismatch happens repeatedly, it is worth investigating the billing event flow instead of just refreshing the page and hoping the UI catches up.

A practical troubleshooting order

The cleanest sequence is usually: confirm the runtime exists, confirm the current account state, confirm the product surface is showing the latest state, then go deeper with terminal or operational inspection only if needed.

This avoids wasting time debugging low-level details when the actual issue is simply that setup or billing state has not finished syncing yet.

Related guides