# 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

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


## Adding Your Key

### Go to "Variables" after deploying 


1. ![](https://documentation.cloud-station.io/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzIyZTc5MWE1LTg3MWYtNGViNy04ZDNmLTg2YzkwNWI4M2NkOC8wNGE4Njg5OS1jMDhmLTQwZWMtYTEwNC1lMTBiZjVkYWI1YTQvQ2xlYW5TaG90IDIwMjQtMTEtMzAgYXQgMTAuMzMuMjdAMngucG5nIiwidHlwZSI6ImF0dGFjaG1lbnQiLCJpYXQiOjE3OTI3Mjk4MDAsImV4cCI6MTc5MjgxNjIwMH0.w8ezAh-XaO5Y3Ly2CMF7Q3ukbI44Lo_x8gJX419GnL0)


### Add your AI key


```hcl
# 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


 ![](https://documentation.cloud-station.io/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzIyZTc5MWE1LTg3MWYtNGViNy04ZDNmLTg2YzkwNWI4M2NkOC85NTdiNDY3MC1kNmM3LTRlZGUtYjlkZS05NzMwMzYxYWY4ZWQvQ2xlYW5TaG90IDIwMjQtMTEtMzAgYXQgMTAuMzEuMThAMngucG5nIiwidHlwZSI6ImF0dGFjaG1lbnQiLCJpYXQiOjE3OTI3Mjk4MDAsImV4cCI6MTc5MjgxNjIwMH0.-D5rmYtDlB5BfG-qsXMT1eTRPxyTQTInjmPrpRPR2bM)


**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

 ![](https://documentation.cloud-station.io/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzIyZTc5MWE1LTg3MWYtNGViNy04ZDNmLTg2YzkwNWI4M2NkOC9iZmRiNzUwMi03MjNiLTQ3YjAtODM4Yy1lN2RjMmY1ZTVmYzAvQXJjIDIwMjQtMTEtMzAgMTAuNDcuMzUucG5nIiwidHlwZSI6ImF0dGFjaG1lbnQiLCJpYXQiOjE3OTI3Mjk4MDAsImV4cCI6MTc5MjgxNjIwMH0.ORDxSWSXIC4FwWNCrM0lVqI83Vu8QR3j6FYf_ZNogb8)


### 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

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

 ![](https://documentation.cloud-station.io/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzIyZTc5MWE1LTg3MWYtNGViNy04ZDNmLTg2YzkwNWI4M2NkOC9lNWZkYjBiZC04NjQyLTRmMTgtODY3NS01ODMwOGI1ZmExZjIvQXJjIDIwMjQtMTEtMzAgMTAuNDYuMDkucG5nIiwidHlwZSI6ImF0dGFjaG1lbnQiLCJpYXQiOjE3OTI3Mjk4MDAsImV4cCI6MTc5MjgxNjIwMH0.a35QfX0wBPp73s8Cd2_NJ0mPFBWIyPdiZAJUGxFkqRM)

---

**Documents**

- [Changelog](https://documentation.cloud-station.io/s/ce6e8846-8aec-4337-a850-5188b6dc6d6e/doc/changelog-r4OVtpiRA5)
- [CloudStation Tutorials](https://documentation.cloud-station.io/s/ce6e8846-8aec-4337-a850-5188b6dc6d6e/doc/cloudstation-tutorials-brnm0gaWUb)
- [Documentation](https://documentation.cloud-station.io/s/ce6e8846-8aec-4337-a850-5188b6dc6d6e/doc/documentation-4X2U9io3hK)
- [Understanding CloudStation Plans](https://documentation.cloud-station.io/s/ce6e8846-8aec-4337-a850-5188b6dc6d6e/doc/understanding-cloudstation-plans-UqY29FsY4w)