Bolt.new Deployment Guide & FAQ

Quick Start Guide

Bolt.new is a platform that lets you create AI-powered web apps instantly. We handle all the technical setup - you just need to:

  1. Click deploy

  2. Add your AI provider's key

  3. Start building!

Setting Up AI Access

To use Bolt.new, you'll need at least one AI provider's key. Think of this like a password that lets your app talk to AI services.


Popular AI Options:

  • OpenAI (GPT-4, etc)

  • Anthropic (Claude)

  • Google (Gemini)

  • Groq

💡 Need free AI credits? Check out: https://github.com/cheahjs/free-llm-api-resources


Adding Your Key

Go to "Variables" after deploying



Add your AI key


# Core AI Providers
OPENAI_API_KEY          # OpenAI (GPT models)
ANTHROPIC_API_KEY       # Anthropic (Claude models)
GROQ_API_KEY           # Groq
GOOGLE_GENERATIVE_AI_API_KEY  # Gemini

# Additional Providers
OPEN_ROUTER_API_KEY    # OpenRouter
DEEPSEEK_API_KEY       # DeepSeek
MISTRAL_API_KEY        # Mistral
HuggingFace_API_KEY    # HuggingFace
XAI_API_KEY           # xAI/Grok
COHERE_API_KEY        # Cohere

Common Questions

Which AI Should I Use?

Larger AI models (like GPT-4, Claude 3.5 Sonnet) generally work best. While smaller models are improving quickly, we recommend starting with the bigger ones for the best experience.


Troubleshooting Common Issues

"Error Processing Request" Check these two places:

  • Your browser's console (Right-click → Inspect → Console tab)

  • The live logs in your CloudStation dashboard




Blank Preview Screen

Don't worry! This usually means the AI needs a small adjustment. Try:

  • Refreshing the page

  • Checking the console for errors

  • Using a different AI provider

Results Not Great? Try switching to a more powerful AI model like:

  • GPT-4

  • Claude 3.5 Sonnet

  • DeepSeek Coder

Managing Your Bolt.new Service

Checking Resource Usage

  1. Click on your profile icon in the top right

  2. Select "Resource Usage" from the dropdown menu

  3. Here you can monitor your current resource consumption



Pausing Your Service

When you're done using bolt.new temporarily:

  1. Find your application card

  2. Click the three dots menu (â‹®) in the top right

  3. Select "Pause Service"

  4. Your service will be paused and won't consume resources

💡 Tip: You can always resume your service later by following the same steps and selecting "Start Service"