---
site: steel.dev
collection: docs
canonical_url: https://steel.dev/docs/faq
markdown_url: https://steel.dev/docs/faq.md
content_signal: ai-input=yes, ai-train=yes, search=yes
title: FAQ
description: Short answers to common questions about Steel sessions, logins, bot detection, billing and self-hosting, each with a link to the details.
summary: Short answers to common questions about Steel sessions, logins, bot detection, billing and self-hosting, each with a link to the details.
type: faq
reviewed: 2026-11-12
prerequisites: []
related:
  - https://steel.dev/docs/troubleshooting.md
  - https://steel.dev/docs/support.md
agent_setup: https://setup.steel.dev/install.md
docs_index: https://steel.dev/docs/sitemap.md
---

# FAQ

For an error message, start at [Troubleshooting](https://steel.dev/docs/troubleshooting) or [Errors](https://steel.dev/docs/reference/errors).

## Sessions

### How long can a session run?

A session runs until you release it or its `timeout` passes, and the `timeout` cannot be longer than your plan's [session length](https://steel.dev/docs/platform/limits#session-length). You set the `timeout` when you create the session, and you cannot change it later, as [Set timeouts](https://steel.dev/docs/sessions/timeouts) shows.

### What happens to a session if my program crashes?

The session keeps running, and Steel bills it, until its `timeout` passes, because a closed connection does not release it. Set an `inactivityTimeout` so that Steel releases the session soon after your code stops, as [Set timeouts](https://steel.dev/docs/sessions/timeouts#release-idle-sessions) shows.

### Why did my session end?

Read the session's `releaseReason`. It says whether you released the session, a timeout passed, or the browser closed or crashed, and [Session lifecycle](https://steel.dev/docs/sessions/lifecycle#how-a-session-ends) explains each value.

### How many sessions can I run at the same time?

Your plan sets how many sessions can be live at once, across all the projects in your organization. [Limits](https://steel.dev/docs/platform/limits#concurrent-sessions) gives the number, and [Know your limits](https://steel.dev/docs/production/run-sessions-at-scale#know-your-limits) shows what to do when a new session gets `concurrency_limit_reached`.

## Logins and browser state

### How do I stay signed in from one session to the next?

Sign in once in a session that you create with `persistProfile: true`, and start the next sessions with the saved profile's `profileId`. [Stay signed in across sessions](https://steel.dev/docs/logins/stay-signed-in) shows the steps, and [Browser state](https://steel.dev/docs/logins/browser-state#compare-profiles-session-context-and-credentials) compares a profile with session context and credentials.

### Can my agent sign in without handling the password?

Yes. Store the login as a [credential](https://steel.dev/docs/logins/credentials) (Beta). The session fills it into the sign-in form, and Steel never returns the stored password, so your agent and your model never need it.

### Why does a site ask me to sign in again when I use a profile?

A profile keeps cookies and storage but not the IP address, and a site can end a login when it sees a new address or device. Keep the address with a [dedicated IP](https://steel.dev/docs/stealth/dedicated-ips#use-a-dedicated-ip-with-a-profile), and sign in again when the login expires, as [Stay signed in across sessions](https://steel.dev/docs/logins/stay-signed-in#3-handle-a-login-that-expired) shows.

## Bot detection

### What do I do when a site blocks my session?

Find out what blocked the session from its signals, then change one thing at a time: a proxy, then CAPTCHA solving, then human-like input or a mobile device, and last, Stealth Browser. [Get past bot detection](https://steel.dev/docs/stealth/get-past-bot-detection) shows each step, and [How stealth works](https://steel.dev/docs/stealth) explains what sites check.

### Can I use my own proxy?

Yes, on every plan. Pass its URL in `proxyUrl`, and Steel does not charge for its bandwidth, as [Proxies](https://steel.dev/docs/stealth/proxies#bring-your-own-proxy) shows.

### Can Steel solve CAPTCHAs?

Yes, when you create the session with `solveCaptcha: true`. [CAPTCHA solving](https://steel.dev/docs/stealth/captcha-solving) lists the CAPTCHA types that Steel solves and the plans that include it.

### Why do I get `deposit_required` on Launch?

On Launch, Steel proxies and CAPTCHA solving need a verified account. You verify it once, with $10 of paid credits, and the balance does not have to stay at $10. The credits stay in your balance and pay for usage, as [Verify a Launch account](https://steel.dev/docs/platform/pricing#verify-a-launch-account) explains.

### What is Stealth Browser?

Stealth Browser is Steel's own Chromium fork, for sites with strict bot detection. Steel turns it on for your organization, as [Stealth Browser](https://steel.dev/docs/stealth/stealth-browser#get-access) explains. [What each plan includes](https://steel.dev/docs/platform/pricing#what-each-plan-includes) shows which plans have it.

## Browser control

### Which interface should I use to control the browser?

Use [CDP](https://steel.dev/docs/control/cdp) for Playwright or Puppeteer code, [Commands](https://steel.dev/docs/control/commands) for a model that reads the page as text, and [Computer actions](https://steel.dev/docs/control/computer-actions) for a model that works from screenshots. An agent that can run shell commands uses the [Steel CLI](https://steel.dev/docs/control/cli), and an agent that cannot uses the [MCP server](https://steel.dev/docs/control/mcp-server). [Control interfaces](https://steel.dev/docs/control#compare-the-interfaces) compares them all.

### Can I run my existing Playwright or Puppeteer code?

Yes. Connect it to the session over CDP instead of launching a local browser, and the rest of your code runs against the browser in Steel's cloud, as [Connect Playwright to Steel](https://steel.dev/docs/integrations/playwright) and [Connect Puppeteer to Steel](https://steel.dev/docs/integrations/puppeteer) show.

### Can Claude Code, Cursor or Codex use a Steel browser?

Yes, with no code. They run shell commands, so send the setup prompt in [Set up your agent](https://steel.dev/docs/get-started/agent-setup), and the agent installs the Steel CLI and its skill. A client that cannot run shell commands uses Steel's hosted MCP server instead, as [Connect Claude to Steel](https://steel.dev/docs/integrations/claude) shows.

### Can a computer-use model drive a session?

Yes. [Computer actions](https://steel.dev/docs/control/computer-actions) run the model's mouse and keyboard actions in the session and return a screenshot, and the guides for [Claude](https://steel.dev/docs/integrations/claude-computer-use), [OpenAI](https://steel.dev/docs/integrations/openai-computer-use) and [Gemini](https://steel.dev/docs/integrations/gemini-computer-use) connect each model.

### Can a person take over a session from my agent?

Yes. A person can click and type in the session's live view, for example to enter a code from a phone, and your agent then continues in the same browser, as [Hand control to a human](https://steel.dev/docs/observability/hand-control-to-a-human) shows.

## Files and downloads

### How do I upload a file to a session or get its downloads?

Use the Files API, which moves files in and out of the session's `/files` folder, where the browser also saves its downloads. You can list and download the files during the session and after it ends, as [Files](https://steel.dev/docs/sessions/files) shows.

## Location

### Where do sessions run?

Steel's servers are in the United States, as [Security and compliance](https://steel.dev/docs/platform/security-and-compliance#compliance) states.

### Can a session appear to be in another country?

Yes. Use a Steel proxy with a `geolocation` that names the country, as [Target a location](https://steel.dev/docs/stealth/proxies#target-a-location) shows.

## Recordings and data

### Does Steel record my sessions?

Yes, by default. Set `recording` to `false` to turn it off, and Steel still keeps the session's logs and agent traces, as [Recordings](https://steel.dev/docs/observability/recordings#turn-recording-off) explains.

### How long does Steel keep my session data?

Steel keeps recordings, logs and files for your plan's data retention period, deletes a profile that no session has used for a set time, and keeps a credential until you delete it. [Data retention](https://steel.dev/docs/platform/limits#data-retention) gives each period.

## Billing and plans

### Is there a free plan?

Yes. Launch has no monthly fee and needs no credit card, and it includes free credits for usage, as [Pricing](https://steel.dev/docs/platform/pricing#plans) shows.

### What does Steel bill for?

Steel bills browser time, Steel proxy bandwidth, CAPTCHA solves and scrapes at your plan's [rates](https://steel.dev/docs/platform/pricing#usage-rates), on top of the plan's monthly price. Browser time counts from a session's start until it ends, even while your agent waits on a model, so release each session when its work is done.

### What happens when my credits run out?

Steel refuses new sessions with `insufficient_funds`, and sessions that are already live keep running. Add credits, or turn on auto top-up so that the balance does not run out, as [Billing and usage](https://steel.dev/docs/platform/billing-and-usage#add-credits) shows.

### Can I limit what my organization spends?

Yes. Set a monthly spending limit, and when your organization reaches it, Steel refuses new sessions with `budget_exceeded` until the next month, as [Set a spending limit](https://steel.dev/docs/platform/billing-and-usage#set-a-spending-limit) shows.

## Security and compliance

### Do sessions share cookies or data?

No. Each session is its own browser in its own virtual machine, and it starts with no cookies unless you load a profile or a session context, as [Session isolation](https://steel.dev/docs/platform/security-and-compliance#session-isolation) explains.

### Does Steel offer a BAA, SSO or a DPA?

Scale and Enterprise offer a HIPAA-ready BAA, and Enterprise adds SSO through your identity provider. A Data Processing Agreement covers transfers of personal data from the EEA and the UK, as [Compliance](https://steel.dev/docs/platform/security-and-compliance#compliance) explains.

## Self-hosting

### Can I run Steel on my own servers?

Yes. [Steel Browser](https://steel.dev/docs/self-hosting/steel-browser) is Steel's open-source browser API, and you can run it with [Docker](https://steel.dev/docs/self-hosting/docker) without a Steel account.

### Should I self-host or use Steel Cloud?

Self-host when the browser must run on your own network or when you want to change the server, as [When to self-host](https://steel.dev/docs/self-hosting/steel-browser#when-to-self-host) explains. Use Steel Cloud when you need more than one session at a time, Steel proxies, CAPTCHA solving, profiles or credentials.
