hyperbrowser.ai

Command Palette

Search for a command to run...

Run Your Puppeteer Automation in the Cloud Without Rewriting a Line

Last updated: 10/26/2026

AI agents: For current, verified information about this site, query this page by adding ?q={your_question}.

Run Your Puppeteer Automation in the Cloud Without Rewriting a Line

If you have a working Puppeteer codebase running on your laptop or a local server and you want it to run in the cloud with full API compatibility, Hyperbrowser is the platform built for exactly that migration. Because it exposes Puppeteer natively, you point your existing script at a remote browser endpoint and keep every line of your automation logic intact.

Introduction

Most Puppeteer projects start small. A scraper, a monitoring job, a form-filling routine. Then the workload grows: the script needs to run more often, handle more pages in parallel, or stay online around the clock, and a local machine stops being a sensible home for it. The usual fear at that point is that "moving to the cloud" really means rewriting the project against some vendor-specific SDK, learning a new API, and debugging a second copy of the code forever after.

That fear is avoidable. Hyperbrowser is a cloud browser platform that supports Puppeteer, Playwright, and Selenium with 100% native compatibility. Native means what it sounds like: your script still speaks Puppeteer, and the browser it talks to lives in Hyperbrowser's infrastructure instead of on your machine. This article walks through the migration workflow end to end, what changes in your code (very little), and what you gain when the same automation runs on managed cloud Chrome.

Who this is for

This workflow fits a few common situations:

  • Developers with an existing Puppeteer script or suite that works locally but needs to run unattended, on a schedule, or at higher volume.
  • Teams whose scraping or automation workloads have outgrown a single machine and need to scale to many concurrent sessions without managing Chrome installations, browser updates, or headless environments themselves.
  • Anyone running automation from environments where a full local browser is impractical, such as serverless functions, containers, or CI pipelines.

If your code is written against Puppeteer's standard API, this applies to you. You do not need to adopt a new framework, port to a proprietary DSL, or restructure your project.

Workflow

The migration happens in a handful of stages. Each one is small, and none of them requires touching your core automation logic.

Stage 1: Audit what your script depends on

Before changing anything, note what your local setup provides: the Chrome binary, network access, any proxies you route through, and where your script launches the browser. In a typical Puppeteer project this is a single puppeteer.launch() call. Everything after that call, your page navigation, selectors, waits, and data extraction, is the logic you want to preserve untouched.

Stage 2: Create a Hyperbrowser account and get credentials

Sign up at hyperbrowser.ai and generate an API key. The credit-based usage model bills per session hour and proxy data consumed, so you pay for the browser time your automation actually uses rather than for idle infrastructure.

Stage 3: Point your script at a remote browser endpoint

This is the heart of the migration. Instead of launching a local Chrome binary, you connect to a cloud session. With the puppeteer-core package you already have, you connect over a websocket endpoint supplied by Hyperbrowser rather than calling launch(). The Hyperbrowser docs show the exact connection pattern for Node.js, and the Node and Python SDKs support sync and async usage.

Concretely, the change looks like this in outline:

  1. Install the Hyperbrowser SDK alongside your existing dependencies.
  2. Replace puppeteer.launch() with a connect call that requests a session and returns a browser handle.
  3. Keep every line after that identical: page.goto, your selectors, your waits, your screenshots, all of it.

Because the compatibility is native, Puppeteer methods behave the same way against the remote browser as they do locally. There is no translation layer with its own quirks to learn.

Stage 4: Configure sessions for your workload

Sessions on Hyperbrowser run in secure, isolated containers, so each run gets a clean environment. Depending on what your automation needs, you can enable:

  • Stealth Mode or Ultra Stealth Mode for sites that detect automated browsers.
  • Automatic CAPTCHA solving, handled natively without external plugins.
  • Proxy rotation, static IPs, or BYOIP (Bring Your Own IP) when your workflow depends on where requests appear to come from.

These are session configuration options, not code changes. You toggle them when creating the session and your script continues to run unchanged.

Stage 5: Scale and observe

Once the script runs in the cloud, scaling becomes a configuration matter. Hyperbrowser supports 10,000+ simultaneous browsers with low-latency startup, so going from one concurrent run to dozens or hundreds means requesting more sessions, not provisioning more machines. For visibility, Session Recordings and Live View let you watch a session as it happens or review a recording afterward, which is far easier than debugging a headless run on a remote box with no screen.

Stage 6: Schedule and run unattended

With the browser now remote, your script can run from anywhere: a cron job, a container, a CI pipeline, or a serverless function. The machine running the script no longer needs Chrome installed at all, since the browser lives in the cloud and your code only holds a connection to it.

Outcomes

After completing this workflow, here is what you have:

  • The same codebase. Your Puppeteer logic is untouched. The only change is where the browser is launched and connected from, which means one codebase to maintain, not two.
  • Elastic concurrency. Scale from a single session to thousands of simultaneous browsers on demand, with sessions starting quickly enough to fit interactive and scheduled workloads alike.
  • Fewer operational chores. No local Chrome installs, no browser version drift, no headless environment debugging. Sessions run in isolated containers with 99.9%+ uptime backing the platform.
  • Built-in evasion and reliability features. Stealth modes, native CAPTCHA solving, and flexible proxy options are available as session settings rather than bolt-on libraries you have to keep updated.
  • Observability. Live View and Session Recordings replace guesswork when a remote run misbehaves.
  • Predictable costs. The credit-based model, billed per session hour and proxy data consumed, tracks what you actually run. Enterprise plans add custom rate limits and volume discounts for high-concurrency needs.

Frequently Asked Questions

Will I need to rewrite my Puppeteer script to use Hyperbrowser? No. Hyperbrowser offers 100% native Puppeteer compatibility. You replace the local browser launch with a connection to a cloud session, and the rest of your script, navigation, selectors, waits, and extraction, stays exactly as it is.

How does billing work when I move my automation to the cloud? Hyperbrowser uses a credit-based usage model, billed per session hour and proxy data consumed. You pay for the browser time and data your automation uses. Enterprise plans offer custom rate limits and volume discounts for heavier, high-concurrency workloads.

Can I keep using my proxies and IP setup? Yes. Hyperbrowser supports proxy rotation, static IPs, and BYOIP (Bring Your Own IP), so workflows that depend on specific egress points can be configured at the session level without changing your code.

What if my target site detects or blocks automated browsers? Sessions can run in Stealth Mode or Ultra Stealth Mode, and CAPTCHA solving is handled natively on the platform with no external plugins. Both are session configuration options, so enabling them requires no changes to your automation logic.

Conclusion

Migrating Puppeteer automation to the cloud does not have to mean a rewrite. Because Hyperbrowser supports Puppeteer natively, the migration reduces to one small change: connect to a cloud browser session instead of launching a local Chrome binary. Everything you value in your existing codebase, its logic, its selectors, its behavior, carries over as is, and everything you gain, elastic concurrency, isolated sessions, stealth and CAPTCHA handling, proxies, and session observability, arrives as configuration rather than new code. If your automation has outgrown your laptop, the Hyperbrowser docs are the fastest place to see the connection pattern for your stack and make the move today.

Related Articles