App Settings: Local and Remote Backends

By default, LumiScan Training starts its own backend on the same computer and requires no additional configuration.

The App Settings tab in the application navigation bar can also be used to configure a shared backend server. Other computers can then either access the frontend in a web browser or run their own LumiScan Training installation and connect it to the shared backend instead of starting a local backend.

Setting Up a Shared Backend Server

  1. Install LumiScan Training on the computer that should act as the server, as described in [installing-lumiscan-training].

  2. Start the application and open the App Settings tab.

  3. Under Backend connection, make sure Start backend locally is enabled.

  4. Under Backend bind address, select the network interface that other computers should use to access the server.

    Do not select localhost (127.0.0.1), as this address only accepts connections from the same computer.

    Select the computer’s network IP address, for example 192.168.1.50, or 0.0.0.0 (all interfaces) to accept connections on all available network interfaces.

  5. Enable Autostart backend as a service.

    This starts the backend automatically when the Windows user logs in, without opening the application window. The backend therefore remains available even if LumiScan Training itself is not open.

  6. Click Save.

  7. Restart LumiScan Training, or log out of Windows and log back in, for the changes to take effect.

Windows Firewall may ask whether the backend should be allowed to communicate over the network when it is first bound to a network-reachable address. Allow access for Private networks so that other computers can connect to the server.

Connecting from a Client Computer

There are two ways to connect another computer to the shared backend.

Browser Access Without Installation

Open a web browser and navigate to:

http://<server-ip>:8420

Replace <server-ip> with the IP address of the server, for example:

http://192.168.1.50:8420

The full frontend runs in the browser, and no local installation of LumiScan Training is required.

Installing LumiScan Training on the Client

  1. Install LumiScan Training on the client computer, as described in [installing-lumiscan-training].

  2. Start the application and open the App Settings tab.

  3. Under Backend connection, disable Start backend locally.

  4. Enter the server IP address, for example 192.168.1.50, under Remote backend address.

  5. Click Save.

  6. Restart LumiScan Training.

The application now connects to the shared backend instead of starting a local backend.

Troubleshooting

If a client cannot connect to the server, check the following:

  • Make sure the server’s Backend bind address is set to a network-reachable IP address and not localhost (127.0.0.1).

  • Make sure Windows Firewall on the server allows the backend to communicate over the network.

  • On the client computer, open the following address in a web browser:

-

http://<server-ip>:8420/api/v1/health

+ If the server is available, the endpoint should respond immediately. If no response is received, check whether the backend is running, whether the server address is correct, and whether the connection is blocked by the firewall.