Skip to main content

Troubleshooting LambdaTest Tunnel

LambdaTest Tunnel helps in establishing an SSH connection between your local machine and our cloud servers to help you perform tests on locally hosted websites and web-apps. With LambdaTest Tunnel, you can ensure how robust your website rendering is across 3000+ real browsers, even before you make it live on the internet.

If due to some unfortunate reason, you are unable to perform cross browser testing using LambdaTest Tunnel then this document will help you troubleshoot the most common challenges.

Oops !! Facing issue while testing your locally hosted application through LambdaTest Tunnel? Here are a few guidelines for you.

Before proceeding, here are some of the common issues:

1. Localhost Refused To Connect

After configuring the tunnel, you might get into the error similar to the below screenshot:

troubleshoot lambdatest tunnel

The error “localhost refused to connect” occurs because of using the URL as localhost which is unfortunately not compatible with various browsers and browser versions. We are deliberately eliminating the URL localhost and recovering it with or your local system IP.

For example you might find above error with URL: https://localhost/demo.html

however, URL: or would definitely work fine for you.

2. Invalid Host Header

While testing an application hosted on your local machine, you may receive an “Invalid Host Header” error message when testing on LambdaTest using a local connection. This error is most commonly caused by a misconfiguration of the application server that causes it to reject non-local connections or reject requests directed at hostnames other than localhost(or any custom one set)

Since, web applications are now built with various different kinds of frameworks like angular, react etc; In order to test it using tunnel the command used to run your web app needs to modified in your project manifest file i.e. “package.json”

troubleshoot lambdatest tunnel
  • Angular Framework Project: For Angular framework based web app, ideally you might be using “ng serve” or “npm start” to run your web application or your package.json file configuration would be set as “ng serve” in order to start your web app and as usual, it would be working fine on local browser. However, this might throw an “Invalid Host Header”error or error something related to the invalid host in a Real Time Test.

To resolve this, here is the quick small solution for you. While running your application, you can either use command ng serve --host --disable-host-check or set your start configuration in package.json file as “ng serve --host --disable-host-check” instead of changing your running command.

  • React Framework Project: For React framework based web app, you need to create an env file in which you have to add the hostname,syntax: HOST=< hostname >, once you are done with it, now you can add your localhost IP along with your hostname in your system hosts file.

Example: < hostname >

This would help you avoiding “Invalid Host Header” error.

3. WordPress - CSS Not Loading

While testing your local web app built through WordPress, you may find issue with the rendering of CSS, similar to the below screenshot:

troubleshoot lambdatest tunnel

The general solution for this is to update the WordPress Address and Site Address on the General Settings tab in the WordPress dashboard with your system IP address rather than the default of localhost, then everything will be emitted relative to that. Here is a screenshot for your further reference:

troubleshoot lambdatest tunnel

By applying the above changes, you would find the CSS loading issue as resolved. Below is a screenshot after the mentioned changed:

troubleshoot lambdatest tunnel

4. IP Whitelisting

If you are testing a server that requires IP whitelisting, then you just have to set up a Local Testing connection and whitelist the below few IP’s for the respective domain:


However be advised, as we are aggressively adding more and more data centers, these IP would be changed, you can see the updated IP’s on this documentation as well.

5. Custom Host Name

Because of some firewall restrictions, your web application might not be accessible on some other servers even after whitelisting the IP’s and configuring the tunnel, in such case you need to make an entry in the hosts file which is used to map hostnames to IP addresses. With the hosts file, you can change the IP address that you resolve a given domain name. This change only affects your own computer without affecting how the domain is resolved worldwide.

This is particularly useful when you wish to see how a website will look like when hosted on a different server without making any DNS changes to your domain.

The location of the hosts file, depending on the operating system that you are using, is:

  • Windows – SystemRoot > system32 > drivers > etc > hosts By default the system root is C:\Windows, so if you are using Windows, your hosts file is most probably:
    C:\Windows\System32\drivers\etc\ hosts)
  • Linux – /etc/hosts
  • Mac OS X – /private/etc/hosts

Let’s say that you wish to resolve to the IP address In this case, you would need to open up the hosts file with a text editor and append the following line:

6. Enable Verbose Logging

The - v flag enables Verbose logging on the console. You can use this to log the HTTP headers & requests or to debug the LambdaTest Tunnel connection.

The requests are also logged into a log file lt.log which is created in the same working directory as the LambdaTest Tunnel binary. You can also specify the tunnel log file name using the --logFile flag.

troubleshoot lambdatest tunnel

7. LT Can’t Be Opened Because Apple Cannot Check It For Malicious Software

Catalina OS users may get the below error from the command line while trying to configure the LambdaTest Tunnel to test their locally hosted web pages: “LT can’t be opened because Apple cannot check it for malicious software”

This error occurs due to the increased restrictions on third-party software, downloaded from the internet. Since Catalina OS is recently launched by Apple, we are working to make our LambdaTest Tunnel compatible with the new OS.

While we are at it, here is a one-time setup workaround. All you need to do is run the below command before you start configuring your LambdaTest Tunnel:

xattr -d ./LT