Access the Litmus Edge Web UI
After successfully installing Litmus Edge, you can access the Web UI from a browser such as Chrome or Firefox.
Important:
- If you can't access features in Litmus Edge when logging in, see the "Activate a License" section below.
- You may see the following error message when working with Analytics: "Http failure response for /analytics/v2/version: 0 Unknown Error". If you see this message, disable any ad-blockers your browser may have.
After you have installed Litmus Edge you can connect to the Litmus Edge device from a browser using the network IP address for the device. The address can be found on the terminal display of the gateway or of the VM terminal.
![URLs to access Web UI URLs to access Web UI](https://images.archbee.com/SSUUxKZUk9bFTEPNn_6Zo/9931JITXoPvPyC_afLHaQ_image.png?format=webp)
Notes:
- The system is accessible from a browser by host name if your computer supports mDNS. This is a convenient feature if your device uses DHCP for address allocation and the address may change time to time. The host name is static and it never changes.
- Make sure that your network is not behind a company firewall or proxy that is blocking the connection.
Refer to the following to log in to Litmus Edge the first time after installing it to your device.
- Make sure you connect your personal computing device (laptop, tablet, desktop) to the network in which the device operates. The Litmus Edge software should be installed on the device that is connected to the same network as your personal computing device so that you can establish a network connection.
- To access the Web UI, you must use Google Chrome, Mozilla Firefox, or Apple Safari. The browser must be able to establish a network connection to the device.
- Gather the Litmus Edge IP address from the terminal window as shown above.
The IP used to access the device is usually the WAN IP or eth0 IP. If the IT and OT networks are segregated, the network used to establish the connection to the PLC system, robotic system, or CNC system is the eth1 network and cannot be accessed from the browser. If no segregation exists, only eth0 is used by both the OT and IT connection. There is no open external API point.
Litmus Edge uses a self-signed certificate, so the browser will most likely block the login for security reasons. Choose the advanced option to bypass the error message. See Browser Issues to learn more.
To log in to Litmus Edge the first time:
- Enter Litmus Edge IP address into the browser address bar.
- Enter the default credentials. The default username is admin and password is litmusedge
- Click Log in.
- A Software License Agreement displays. Review the agreement and click Accept.
- Follow the prompts to change your password.
- Litmus Edge opens in your browser. The Dashboard page appears by default. You are now logged into Litmus Edge.
![Litmus Edge EULA Litmus Edge EULA](https://images.archbee.com/SSUUxKZUk9bFTEPNn_6Zo/jylJDLd7xXhH8gUyZp5QC_image.png?format=webp)
![Change default password on first login Change default password on first login](https://images.archbee.com/SSUUxKZUk9bFTEPNn_6Zo/XkJ5ock_dmAPjh88iAbi6_image.png?format=webp)
![Litmus Edge Dashboard Litmus Edge Dashboard](https://images.archbee.com/SSUUxKZUk9bFTEPNn_6Zo/JTLWE8-wOtgk2p1au6Z3x_image.png?format=webp)
Password requirements are applied when you reset your password or create user accounts within Litmus Edge. At the first login, you will be prompted to change the default password. When creating a password, the password must meet the Password Policy Management Requirements. See Policy Management for more information.
Notes:
- Do not forget your password. For security reasons, there is no password recovery. If you lose the administrator password, you must reinstall Litmus Edge.
- In some cases, you may need to use the Terminal User Interface as you may have no direct network access to the device. In this case, you can connect locally to the device using a keyboard, mouse, and monitor. This will allow you to perform the required network setup to make the device accessible through the Web UI.
The user name icon at the top-right of the Litmus Edge toolbar opens a menu that offers support and information options.
- User Manual: Opens the Litmus Documentation Portal where you can select the relevant guide or manual.
- Litmus Support: Opens Litmus Customer Portal where you can contact the support team.
- Litmus University: Opens Litmus LMS where you can take online courses for Litmus products.
- View License: Displays the End-User License Agreement.
![Litmus Edge Support Links Litmus Edge Support Links](https://images.archbee.com/SSUUxKZUk9bFTEPNn_6Zo/AkYnTY8DMJSuH8AZdl6fn_image.png?format=webp)
You will need to activate a license to access Litmus Edge features if:
- Your trial license or production license has expired.
- You are running Litmus Edge through Docker.
Note: If you can access Litmus Edge features and would still like to activate a license, see Activate a License Online if Your Current License is Not Expired and Activate a License Offline if Your Current License is Not Expired.
To decide the most optimal license for your Litmus Edge configuration, see Site and Node-Locked License Overview for Litmus Edge for details. You have the following options for activating a license.
To activate Litmus Edge with Litmus Edge Manager, Litmus Edge Manager must have a site license on its own license server. See Activate an Edge Device to learn more.
![Activation fields for Litmus Edge Manager activation Activation fields for Litmus Edge Manager activation](https://images.archbee.com/SSUUxKZUk9bFTEPNn_6Zo/JLiB--oTbxF-bMucYduM5_image.png?format=webp)
You can activate a Litmus Edge license by setting a license server in Litmus Edge under Advanced Options. See Set a License Server to learn more.
![License Server Settings option License Server Settings option](https://images.archbee.com/SSUUxKZUk9bFTEPNn_6Zo/OIGsv_Q4621EFm8IHq4WQ_image.png?format=webp)
You can activate a node-locked license for the Litmus Edge instance under Advanced Options. See Activate a License Online if Your Current License is Expired and Activate a License Offline if Your Current License is Expired to learn more.
![Node-locked license Node-locked license](https://images.archbee.com/SSUUxKZUk9bFTEPNn_6Zo/qUgoS0VxjAYk111YGBlFV_image.png?format=webp)