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.

Related guides