Common Issues and Troubleshooting - Read this Before Posting Here!

[NOTE: This post will be updated will more details over the week, and I will be making a video on common issues soon!]

Since everyone is running bolt.diy with different systems and providers, and also because bolt.diy is still in its infancy, there are certainly many people who run into issues getting it up and running and working as expected!

Before posting an issue that you have, please read through these common issues and how to dive into them a bit deeper:

  1. “There was an error processing this request”

If you see this error within bolt.diy, that is just the application telling you there is a problem at a high level, and this could mean a number of different things. To find the actual error, please check BOTH the terminal where you started the application (with Docker or pnpm) and the developer console in the browser. For most browsers, you can access the developer console by pressing F12 or right clicking anywhere in the browser and selecting “Inspect”. Then go to the “console” tab in the top right.

I’m not giving a solution per say here, but you will almost certainly see a more helpful error message in one of these two places!

  1. x-api-key header missing

I’ve seen this error a couple times and for some reason just restarting my Docker container has fixed it. This seems to be Ollama specific. Another thing to try is try to run bolt.diy with Docker or pnpm, whichever you didn’t run first. If anyone can provide more details on this one specifically I would appreciate it!

  1. Blank/no preview

I promise you that we are constantly testing new PRs coming into bolt.diy and the preview is core functionality, so the application is not broken! When you get a blank preview or don’t get a preview, this is generally because the LLM hallucinated bad code or incorrect commands. We are working on making this more transparent so it is obvious! Sometimes the error will appear in developer console too so check that as well.

For best models to get blank previews the least amount possible, use the old Claude 3.5 Sonnet, GPT-4o, Gemini 2.0, Qwen 2.5 Coder 32b, or DeepSeek Coder V2.

  1. Everything works but the results are bad

As much as the gap is quickly closing between open source and massive close source models, you’re still going to get the best results with the very large models like GPT-4o, Claude 3.5 Sonnet, and DeepSeek Coder V2 236b. This is one of the big tasks we have at hand - figuring out how to prompt better, use agents, and improve the platform as a whole to make it work better for even the smaller local LLMs!

  1. Received structured exception #0xc0000005: access violation

If you are getting this, you are probably on Windows. The fix is generally to update the Visual C++ Redistributable:

8 Likes

Hi All,
This is my first post. I’m having trouble running Bolt.diy. I get the error message 1. “There was an error processing this request”. I have opened the “Inspect” on my chrome browser on the localhost tab. I have found 19 error’s, none of which I know how to fix lol. but I have run them through ChatGPT and asked for a brief, which I will provide.Troubleshooting list.. If someone could help me to resolve these that would be fantastic. I’m so looking forward to having this running.

2 Likes

Hey @storemanjoe77, thanks for posting your errors! Are there any errors you see in the terminal where you started bolt.diy with pnpm/Docker? A lot of times those console errors can be ignored but any errors in the terminal could be super helpful.

1 Like

Following all the install instructions, I get to the final result showing that bolt.diy is successfull installed:
image
The only problem is I can’t acces it through my browsers : Chrome or Edge. Is there any specific settings at the browser level to make it work ? I spent hours trying to find a workaround without success.

@philhawks Welcome,
what error do you get when trying to open http://localhost:5173 in your browser?
There is nothing specific. Just make sure you are on the same system as you run bolt (localhost)

PS: If you are on windows, take a look at my video tutorial. Maybe you see/find what is different on your system.

Here you go for the error displayed:

Can you post a screenshot side by side (console and browser please).

Also make sure no other application running on port 5173 as shown in my video.

Also you can try to access via: http://127.0.0.1:5173 instead of localhost. Maybe your local dns entries are broken.

just to be sure, you tried to open it while the server was running, cause in your terminal it is not running anymore

You’re absolutely right, thank you. I re-run it and it works now. Thanks for you help.

2 Likes

Glad you got this resolved! Thanks for your help @leex279!

1 Like

I follow the steps to deploy bolt.diy but this erorr keeps accuring
I believe that somthing stoping it I tried to disable the antivirus but it didn’t change a thing

Hi @maaroufiabdslam,

hard to say whats going wrong without knowing how you installed and startet.

Take a look at my install Video for windows. If you still get problems, open a seperate topic please within [bolt.diy] Issues and Troubleshooting to keep this clean.

2 Likes

hello leex thanks for replying i already watched your video two times
I simply followed the steps for developpers download in github also i searched for it and it seems like somthing preventing "esbuild " from running so i think the problem s in my laptop

1 Like

Im not sure about this, maybe you mixed just something up with PNPM and NPM maybe? If you did then you would need to start from scratch at best and clone the project again, instead of doing npm and then a pnpm after it, cause this will not work without cleaning up manually before.

A few things you can check:

node --version // should be Version 22.x

Quick steps to install:

git clone -b stable https://github.com/stackblitz-labs/bolt.diy  
cd bolt.diy
pnpm install
pnpm run dev

Make also sure you really installed the latest MS C++ Redis as shown in the video and linkend in the task list: https://task-list-advanced.netlify.app/ (“Windows Bolt Installation” from examples)


I checked the node version and it is 22.13.1 also i reinstall it from scratch and keeps this error accuring

Hello there,

im installing bolt.diy and I almost got it after 2 hours of sweating (im a noobie). But no im facing this error; “There was an error processing your request: Custom error: Unauthorized” whenever I type a prompt… and in the terminal it says this weird prompt. would be amazing if someone could help me.