QuickStart Guide

Access the Litmus Edge Web UI

12min
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 docid\ zaowl1npjlkefhjbxhgvu "http failure response for /analytics/v2/version 0 unknown error" if you see this message, disable any ad blockers your browser may have access from a browser 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 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 log in to the litmus edge web ui the first time 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 docid\ l3aqn01m t0xsc65te1bc 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 password requirements 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 docid\ kvpb8qgtzjfidvzh0rj6b 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 access the terminal user interface docid\ gsdvwb7qwhdhuqf7fkahc 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 support links on litmus edge 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 activate a license 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 node locked license online docid\ c4rxnts6xmpvg iibp9zf and activate a node locked license offline docid\ ykew5eavydqisadm ks61 to decide the most optimal license for your litmus edge configuration, see site and node locked license overview for litmus edge docid\ kcvcr7hsx5pkvjfu9qdc7 for details you have the following options for activating a license option 1 activate litmus edge with litmus edge manager 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 docid\ tdj648wjgatvqzyx79uwb to learn more option 2 activate litmus edge with license server you can activate a litmus edge license by setting a license server in litmus edge under advanced options see set a license server docid\ enpnxgnst2qepbjdzlrqh to learn more option 3 activate node locked license you can activate a node locked license for the litmus edge instance under advanced options see activate a node locked license online docid\ c4rxnts6xmpvg iibp9zf and activate a node locked license offline docid\ ykew5eavydqisadm ks61 to learn more