Test Web Apps in Local Network

Last modified on July 29, 2021

When developing web applications, it is a common practice to implement their interim work-in-progress versions in local environments. Usually, these environments are restricted from the global Web to prevent unwanted external access from outside the organization.

To test these applications, LoadNinja needs a tunnel – a private connection between the LoadNinja engine and the tested web app. You can set it up with a lightweight desktop utility available in your LoadNinja settings (see below).

Set up the tunnel

  1. Log in to LoadNinja, and go to  > Settings > Tunnel.

  2. Download the installation package to your computer. LoadNinja offers the utility versions for popular operating systems:

    Tunnel download links

    Click the image to enlarge it.

    The utility is lightweight and can work on almost any computer (even on relatively “weak” one). You can find system requirements below.

  3. Unpack files from the downloaded page to some folder on your hard drive. Run the LoadNinja Tunnel executable.

    Depending on security settings active on your computer, the operating system can ask your approval to run the utility. Allow the run.

  4. Once the utility starts, enter the email address and password of your LoadNinja account, and click Connect:

    The Tunnel utility

    Click the image to enlarge it.

  5. Once the tunnel has been set up, you will see Connected:

    The tunnel application: Connected

    Click the image to enlarge it.

    You can then minimize the utility and leave it running in the background.


  • Proxies and firewalls running in your network should allow the tunnel utility to connect to the Web.

    Also, depending on the security settings of your operating system, you may need to permit the utility to access the Internet.

  • To command the utility to connect to the Web via another proxy, select Connect using proxy on the utility’s main screen, then specify the connection settings: the IP address or hostname, port, user name, and password.

System requirements

  • Operating system:

    • 32-bit or 64-bit Windows: Windows 7, Windows 8.1, Windows 10, Windows Server 2008 R2, or Windows Server 2012.
    • 32-bit or 64-bit Linux distribution: Ubuntu 14.04 or later, Debian 8 or later, openSUSE 13.3 or later, Fedora Linux 24 or Later.
    • 64-bit macOS Mavericks 10.9 or later.
  • For Windows and Linux: An SSE2-capable Intel Pentium 4 processor or higher.

  • 160 MB of free disk space.

Check if the tunnel is active

To check whether the tunnel is on or off:

  • Open the minimized LoadNinja Tunnel utility (if you have started it) and see it shows Connected.

    – or –

  • Log in to LoadNinja, go to  > Settings > Tunnel and check the Status label:

    Tunnel Status: On

    Click the image to enlarge it.

Record UI tests for local web apps

  1. Open LoadNinja.

  2. Start the tunnel utility, sign in with your LoadNinja account and wait until the tunnel is up and running:

    Starting the tunnel

    Click the image to enlarge it.

    If you have not set up and configured the utility, do this as it is described above.

  3. Select Create Test > UI Test on the LoadNinja toolbar.

  4. In the subsequent dialog, enter the URL of your local website and select the This website is not publicly available check box:

    Start recording a test of a local web app

    Click the image to enlarge it.

    Click Start Recording.

  5. LoadNinja will check if the tunnel is set up and running:

    • If everything is OK, LoadNinja will start recording automatically.

    • If this is not the case, LoadNinja will suggest downloading and configuring the tunnel:

      Start recording a test of a local web app

      Click the image to enlarge it.

      If LoadNinja fails to find an active tunnel, click Retry at the top of this dialog box.

  6. Record a UI test as usual. Work with the pages as a regular user would normally do this: click links, input texts, scroll the pages, and so on. See also 2. Record UI Test.

Launch load tests against internal web apps

  1. In LoadNinja, go to the scenario creation form.

  2. Add a UI test you have recorded against your local web app.

  3. Add up to 15 virtual users.

  4. Specify the remaining settings as needed.

  5. Launch the test as usual.

    If you use the tunnel, you cannot specify server locations. In this case, LoadNinja uses the default location: US East (N. Virginia).

Increase the load

To perform load testing of local applications with more than 15 virtual users involved:

  1. Go to the scenario creation form.

  2. On the Load Configuration panel, select the Display load generator IPs before starting the test check box.

After that, launch the test as you normally would.

You will see the IP addresses of all the load generating instances before the test run starts. Modify your firewall rules and supply the tested web application with an external IP address to allow virtual users to interact with your app, or contact your network administrator for assistance.

Static IPs

To make testing of your local applications even more convenient, consider purchasing a static IP for the load generator. You can then configure your proxy settings to allow traffic from this static IP to your network, so you will not need to check the load generator IPs every time you launch a load test.

To learn more, send an email to loadninjasales@smartbear.com or call us at +1 617-684-1747.

To be able to record and run load tests, allow traffic from the IPs specified on the Settings > Static IP tab.

See Also

Test Single-Page Applications
Use Cases

Highlight search results