Internal Environments
Visual regression runs are executed by headless workers that live in public cloud networks. If you are developing locally on localhost or running private staging clusters behind a firewall, our cloud workers cannot natively resolve your endpoints.
Playwright Integration (No Tunnels Required)
The recommended way to test local or private environments is to use our native Playwright Integration.
How it avoids tunneling:
Instead of having RegressionBot's cloud workers fetch your website, Playwright runs the browser tests locally (where localhost:3000 or your private network is fully accessible). The SDK captures the screenshots locally and uploads the PNG buffers directly to RegressionBot.
This completely eliminates the need for third-party tunneling software like ngrok or opening firewall ports.
Secure Tunneling Workarounds
The easiest and most secure way to test internal environments without permanently exposing staging hosts is to establish a temporary, secure tunnel during your CI pipeline run or local testing.
1. Cloudflare Tunnel
Expose your local development port (e.g. 3000) using a secure Cloudflare tunnel domain during CI runs:
# Spin up a temporary tunnel
cloudflared tunnel --url http://localhost:3000Use the generated ephemeral trycloudflare.com URL as your preview URL in RegressionBot.
2. ngrok
Instantly map a public HTTPS gateway directly onto your locally hosted development/staging servers:
# Spin up ngrok tunnel on port 8080
ngrok http 8080Pass the returned *.ngrok-free.app address to the visual crawler run.
Public Access Constraints
If tunneling scripts are not permitted in your infrastructure, you must ensure your pre-production domains have a public route.
Because visual crawlers capture screenshot buffers on real headless browser frames, all stylesheets, images, and fonts must be accessible publicly by our workers over the web.
IP Whitelisting & VPN Gateways
We are actively designing features to support enterprise whitelisting and corporate VPN VPC integrations:
We are currently recruiting customers for our private beta supporting dedicated VPC gateways and proxy agents.
Please reach out to us at support@regressionbot.com to request access or join the waitlist, and we'll get right back to you.