Skip to content

FAQ

Set up your agent

Give your coding agent a Steel browser and the Steel skills, so that it browses and writes Steel code the right way. Learn more

Install the Steel CLI. It signs you in and installs the skills for your coding agents.

curl -fsS https://setup.steel.dev | sh

Or send this prompt to your coding agent, and it does the same:

Read https://setup.steel.dev/install.md and follow it to set up Steel for this coding client.
Then continue my requested task using the installed Steel skill.

Set up your agent →

For an error message, start at Troubleshooting or 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. You set the timeout when you create the session, and you cannot change it later, as Set 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 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 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 gives the number, and 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 shows the steps, and Browser state compares a profile with session context and credentials.

Can my agent sign in without handling the password?

Yes. Store the login as a credential (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, and sign in again when the login expires, as Stay signed in across sessions 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 shows each step, and How stealth works 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 shows.

Can Steel solve CAPTCHAs?

Yes, when you create the session with solveCaptcha: true. 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 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 explains. What each plan includes shows which plans have it.

Browser control

Which interface should I use to control the browser?

Use CDP for Playwright or Puppeteer code, Commands for a model that reads the page as text, and Computer actions for a model that works from screenshots. An agent that can run shell commands uses the Steel CLI, and an agent that cannot uses the MCP server. Control 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 and Connect Puppeteer to Steel 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, 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 shows.

Can a computer-use model drive a session?

Yes. Computer actions run the model's mouse and keyboard actions in the session and return a screenshot, and the guides for Claude, OpenAI and Gemini 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 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 shows.

Location

Where do sessions run?

Steel's servers are in the United States, as Security and 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 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 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 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 shows.

What does Steel bill for?

Steel bills browser time, Steel proxy bandwidth, CAPTCHA solves and scrapes at your plan's 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 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 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 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 explains.

Self-hosting

Can I run Steel on my own servers?

Yes. Steel Browser is Steel's open-source browser API, and you can run it with 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 explains. Use Steel Cloud when you need more than one session at a time, Steel proxies, CAPTCHA solving, profiles or credentials.