Testing on localhost/VPN
Using LogRocket with an internal server or local dev environment
LogRocket supports capturing sessions from local development or internal servers, but with some conditions.
However, LogRocket can't capture a resource if it's not accessible from our servers. This might happen if you are using
localhost or are on a private VPN. If this is the case, LogRocket has a "fallback mode" which will fallback to using the "live" version of the resources during playback.
"Fallback mode" only works if the browser that you are using to watch user sessions can reach your application server during replay. Additionally, the application server must serve assets over
https, or else the browser will block loading of the local assets.
There a few workarounds to this problem which allow you to use LogRocket in local development:
Using Ngrok for local testing
One solution is to use ngrok to make your application server accessible to our servers.
If you have a webserver running at
localhost:3000, follow these steps to ensure that replay mode works correctly:
- Install ngrok from https://ngrok.com
- Run ngrok with your localhost port: (ie.
ngrok http 3000if you are running a server at
- Open your application at the specified
- View the associated LogRocket recording.
When using ngrok, make sure to use the https link to view your website (e.g. https://cc6004ec.ngrok.io) rather than http.
Enabling browser "insecure mode"
If you can't make your
localhost server accessible to the public internet, you can use "fallback mode" by changing your browser settings.
Firefox - Enable mixed content
Chrome - Run Chrome with the
- Mac OSX:
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --allow-running-insecure-content &
These workarounds are only necessary when trying to test on a locally-running server. Real production traffic can be served over
https and LogRocket will be able to snapshot your resources without any additional work from a developer.
You can also make assets available on a public URL. See Accessing Private Assets for how to configure this.
Updated 6 months ago