Skip to content

docs(blog): add post on using Lightpanda as a remote browser - #4156

Open
candidosales wants to merge 2 commits into
apify:masterfrom
candidosales:docs-lightpanda-guide
Open

candidosales wants to merge 2 commits into
apify:masterfrom
candidosales:docs-lightpanda-guide

Conversation

@candidosales

@candidosales candidosales commented Sep 23, 2026 •

Copy link
Copy Markdown

Replaces #3481. Per review, moves the Lightpanda guide out of the official docs into a community blog post, since Lightpanda is a third-party project.

With the v4 remote browser support, Lightpanda works with the existing PlaywrightCrawler and PuppeteerCrawler. The post covers:

  • connecting to a running Lightpanda server with remotePlaywrightBrowserPool() and maxOpenPagesPerBrowser: 1. Lightpanda allows one browser context per CDP connection, so the short remoteBrowser: { endpoint } form doesn't work.
  • a RemoteBrowserProvider that starts one Lightpanda process per browser, since Lightpanda sets its proxy per process (--http-proxy).

Tested against Lightpanda 0.4.1 with Playwright and Puppeteer.

Lightpanda exposes a CDP server, so PlaywrightCrawler and PuppeteerCrawler
can use it through remotePlaywrightBrowserPool / remotePuppeteerBrowserPool.
The guide covers the one-context-per-connection limit
(maxOpenPagesPerBrowser: 1) and a RemoteBrowserProvider that starts one
Lightpanda process per browser for per-browser proxies.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

@barjin barjin left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you for the contribution @candidosales !

Having this in the official Crawlee guides means we'd need to keep this up to date. Since Lightpanda is a third-party project, I'd prefer to keep it out of the official docs.

Would you mind turning this into, e.g., a Crawlee blog post? See my (very similar) PR on Obscura support - perhaps you can draw inspiration from this?

Thanks again!

Lightpanda is a third-party project, so keep it out of the official
guides and publish it as a community blog post instead.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@candidosales candidosales changed the title docs: add Lightpanda guide using remote browser pools docs(blog): add post on using Lightpanda as a remote browser Sep 24, 2026

@barjin barjin left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you @candidosales !

The post is good to go by me 👍 I'll keep this unmerged until Crawlee v4 is out - the examples could be confusing for users nowadays (current crawlee@latest is v3, which doesn't have the remote browser support).

There is no further action required from you, the post imo reads well. I'll update this PR once the v4 is out on npm as stable.

Cheers!

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants