Troubleshooting
Boltise won’t start
Section titled “Boltise won’t start”- Confirm you are on Windows 10 or 11 (64-bit).
- Check Windows Event Viewer for crash logs.
AI chat
Section titled “AI chat”No response, or it loads forever
Section titled “No response, or it loads forever”- Confirm you are signed in.
- Check that you have AI available at all. Hosted Boltise AI needs a paid plan — Plus, Pro or Max. On the Free tier nothing will answer until you add your own API key in Settings ▸ AI Providers. See Bring Your Own Key.
- Check your internet connection.
- If you use your own key, verify it in settings.
“You have used all your AI usage for this billing period”
Section titled ““You have used all your AI usage for this billing period””You have spent this cycle’s Boltise AI credits. They reset on your billing anniversary, when the renewal payment goes through — not on a rolling 30-day clock, and not on the first of the month.
That distinction matters if a payment fails or is late: the credits do not come back until it is processed, so a card that needs updating will look like an AI outage. Check your billing details first.
To keep going straight away, upgrade at boltise.ai/pricing, or add your own API key — BYO keys are never metered by Boltise. See Bring Your Own Key.
“Invalid or expired token”
Section titled ““Invalid or expired token””Your session expired. Sign out and back in.
Database
Section titled “Database”“No database selected” in Build
Section titled ““No database selected” in Build”Connect to MySQL first in the Database Manager. The export toggle only appears with an active connection.
Can’t connect
Section titled “Can’t connect”- Confirm the MySQL or MariaDB server is running.
- Recheck host, port, username, and password.
- Allow remote connections if the database is not on localhost.
Server management
Section titled “Server management”FXServer won’t start
Section titled “FXServer won’t start”- Confirm FXServer is installed and the path is set.
- Make sure
server.cfghas a valid license key. - Read the console output for the specific error.
Console shows garbled text
Section titled “Console shows garbled text”Your terminal may not support color codes. It is cosmetic and does not affect the server.
Performance
Section titled “Performance”Slow file tree
Section titled “Slow file tree”Boltise virtualizes the file tree. With thousands of files the first scan takes a few seconds; later loads are cached.
High memory
Section titled “High memory”- Close unused tabs.
- Stop resources you are not working on.
- Restart Boltise if it climbs past about 1 GB.
Help us improve these guides
Allow anonymous page and key-link counts? We use PostHog in the US. No session recording. You can change this below at any time.