Lanorix server guide
The built-in server on the administrator’s computer: data, firewall, connecting PCs, the cloud, access from the internet, command protection and backups. For advanced setups, a dedicated server.
The Lanorix server is built into the app: it runs on the computer where “This is the administrator’s computer” (“Это компьютер администратора”) was chosen on first start. The employees’ Lanorix apps connect to it; requests, files, screen sharing, scripts and equipment inventory all go through it. All office data is stored on this computer. You do not need to install a server separately; that is an advanced option.
The Lanorix app may show its interface in Russian. Where it helps, the original Russian label is given in parentheses.
1. The built-in server
- Install
Lanorix-Setup-0.18.1.exeon the administrator’s computer and choose “This is the administrator’s computer” (“Это компьютер администратора”). - The server starts on its own, without a window, and from then on starts with Windows. The console signs in automatically, so you do not need to enter the admin code.
- If Windows shows a firewall prompt to allow access, allow it for private networks.
The server data is stored in %APPDATA%\Lanorix\server:
lanorix.db: the database with devices, zones, requests, access, the log and the encrypted vault;server.log: the server log (opened with “Server log” (“Журнал сервера”) in the tray menu);admin-code.txt: the admin code created on first start. You only need it for manual sign-in (“Other options”) or to sign in to the console from a browser. Keep it as safe as a domain administrator password: the code gives control over all computers, including running scripts.
The tray icon menu: “Open console” (“Открыть консоль”), this PC’s address, “Server log” (“Журнал сервера”) and “Change mode…” (“Сменить режим…”).
The server works without the internet. An internet connection is only needed occasionally to check the subscription: the license is remembered for 7 days, followed by a grace period.
2. Choosing a computer
- A computer that is usually on: your own work PC or a small always-on PC in the office. While it is off, employees cannot use the chat and the console cannot see them.
- On the same network as the employee computers: automatic discovery works only within one subnet.
- Only the administrator should have access to it: it holds the office data and the admin code.
3. Firewall and server address
Employee computers find the server with a UDP broadcast (port 8788) and connect to it on port 8787. That is why the Windows network access prompt on first start must be answered with “Allow” for private networks. If the prompt was declined, allow Lanorix manually: “Windows Defender Firewall” → “Allow an app or feature through Windows Defender Firewall” → Lanorix → “Private”.
This PC’s address is shown in the console and in the tray menu. Employees on another subnet or on guest Wi-Fi need it: they enter it under “Other options” (“Другие варианты”) with port 8787. To keep the address from changing, reserve it in the router settings (DHCP reservation).
4. First steps in the console
- Install the app on employee PCs and choose “Employee computer” (“Компьютер сотрудника”).
- Accept new computers: a banner “New computer: … — Accept / Decline” (“Новый компьютер: … — Принять / Отклонить”) appears on the console’s Home page (on first start the setup wizard does the same). Accepted PCs go to the group “All computers” (“Все компьютеры”); you can sort them into departments later.
- Create keys on the “Protection” tab (“Защита”) (see section 8) and a master password on the “Vault” tab (“Хранилище”).
What each console section contains is described in the app guide.
5. Connecting PCs without a password
By default, new employee computers connect without a password, but only after the administrator clicks “Accept”. To turn this off, click “PC connection and internet access…” (“Подключение ПК и доступ из интернета…”) under “Computers” → “Groups and sign-in” (“Группы и входы”) and switch off the toggle “Connect new PCs without a password (with approval)” (“Подключать новые ПК без пароля (с подтверждением)”). Groups with a login and password keep working as before: the employee signs in via “Other options”.
6. Connecting to the cloud
The cloud is optional. It lets administrators sign in with the company account (with 2FA). Without it, the built-in server works and the console signs in automatically.
- Sign up on lanorix.su and create a company in the dashboard; the trial period starts.
- In the dashboard: company → “Server keys” → “Create key”. Copy the key (it starts with
npk_); it is shown only once. - In the console: “Subscription and cloud” (“Подписка и облако”) → the cloud address
https://lanorix.suand the key → save.
The subscription is checked roughly every 6 hours; the time of the last check is shown in the dashboard. Create a separate key for each server (for example, for a branch office). If you lost a key or it may have leaked, revoke it and create a new one.
7. Access from the internet
By default, the server works only inside the office. If employees or the administrator need to connect from home:
- Put a reverse proxy with a certificate, such as Caddy or nginx, in front of the server so that it has an external
https:///wss://address, for examplehttps://lanorix.example.ru. The app will not accept an unencrypted address from the internet. - In the console, open “Computers” → “Groups and sign-in” and click “PC connection and internet access…” (“Подключение ПК и доступ из интернета…”):
- “Allow connections from the internet” (“Разрешить подключение из интернета”);
- “New PCs from the internet wait for administrator approval” (“Новые ПК из интернета ждут одобрения администратора”): keep this on, so that a stranger’s computer cannot connect without your confirmation;
- enter the external server address and the zones whose PCs may connect from outside;
- “Allow admin sign-in with the code from the internet” (“Разрешить вход админа по коду из интернета”) is best left off: the code can be brute-forced. Sign in with the company account instead.
- New PCs appear in the “Awaiting approval” list (“Ожидают одобрения”) in this window. Only the company owner can change these settings and approve PCs.
Screen sharing over the internet requires a TURN server (the iceServers parameter in the app’s config.json); on the local network it is not needed.
8. Command protection
The “Protection” tab (“Защита”) turns on command signing: computers run commands (scripts, access settings) only if they are signed with the administrator’s key. Even if the server or the cloud is compromised, an attacker cannot run code on the PCs.
- “Create protection keys” (“Создать ключи защиты”): an administrator name (Latin letters) and a key password of at least 10 characters.
- “Publish to server” (“Опубликовать на сервер”): the computers receive the public part of the key.
- Before important actions, unlock the key with the password; it locks itself again after a while. Compare the owner key fingerprint shown on the tab with the zone code.
- Watch the expiry date of the key certificate: when 14 days or fewer remain, the row turns red.
The key password cannot be recovered, so write it down.
9. Backups and updates
Everything the server knows is stored in lanorix.db in %APPDATA%\Lanorix\server.
- Backup: copy
lanorix.dbto another drive or computer regularly (for example, once a week and before every update). - Restore: quit the app (tray icon → Quit Lanorix (“Закрыть Lanorix”); the built-in server stops with it), replace
lanorix.dbwith the backup copy and start the app again. - The password vault in the backup is encrypted with the master password: without it, neither you nor anyone else can read it.
- Keep the backup where outsiders have no access: the database contains information about computers and employees.
- Update: from version 0.13 updates arrive automatically: the app checks lanorix.su every 6 hours and installs only updates signed by Lanorix. Employee computers update on their own (the owner can turn automatic updates off for employee computers); on the administrator’s computer the update is installed with the “Install … and restart” button under Settings → Command protection → Updates. Versions older than 0.13 need one manual install: download the new installer from the website and install it over the current version. Before updating the administrator’s computer, back up
lanorix.db. - Moving to a dedicated server and back: “Settings” → “Backups and server” → “Move data…” (see data move); a Linux server is updated with the “Update server” button (details).
- If the computer with the server is sold or decommissioned and the server was connected to the cloud, revoke its key in the dashboard.
10. Dedicated server (advanced)
The easiest options are the “This is the office server” mode on a separate Windows PC (guide) or an install on Linux over SSH from the app (guide): data can be moved over from your computer and employees connected with an invitation. Below is the manual option with lanorix-server.exe.
For larger offices, for access from the internet, or if the administrator’s computer is often switched off, the server can run on a separate always-on computer using lanorix-server.exe. It is no longer on the “Download” page: the archive with the dedicated server is available on request via support. In this case the administrator’s and employees’ apps connect to the server via “Other options” (“Другие варианты”).
Choosing a computer
- A computer that is always on: a mini PC, an office server or a workstation that is not switched off at night.
- A fixed IP address on the office network: reserve it in the router settings (DHCP reservation); otherwise employees will have to change the server address.
- Only the administrator should have access to it: the server holds the office data and the admin code.
Installation and first start
- Create a folder, for example
C:\Lanorix\Server, and putlanorix-server.exeandstart-server.batin it. - Run
start-server.bat. The server window opens. Do not close it: closing the window stops the server. - On the first start, the window shows the admin code once. Write it down and keep it as safe as a domain administrator password.
All data of the dedicated server is stored in a single file, lanorix.db, next to the program.
Firewall and address
The server accepts connections on port 8787. Open it in the inbound rules of Windows Firewall on this computer (PowerShell as administrator):
New-NetFirewallRule -DisplayName "Lanorix Server" -Direction Inbound -Protocol TCP -LocalPort 8787 -Action Allow -Profile Private,Domain
The server address for the apps is the computer’s IP and the port, for example 192.168.1.10:8787. To find the IP, run ipconfig and look at “IPv4 Address”. The administrator console also opens in a browser: http://192.168.1.10:8787/.
Starting with Windows
To have the server start on its own after a reboot, add start-server.bat to Windows Task Scheduler: “Create Task” → trigger “At log on” (or “At startup”), action: start start-server.bat, start in: the server folder. After a reboot, check that the employees’ apps connect.
Connecting the apps
Administrator: “Other options” → the administrator tab, the server address and the admin code (or the company account). Employees: “Other options” → the server address and the login and password of a group created under “Computers” → “Groups and sign-in”.
Backups, updates and moving
- Backup: stop the server (close its window), copy
lanorix.db, then start the server again. Restore: stop the server, replacelanorix.dbwith the backup copy, start the server. - Update: stop the server, back up
lanorix.db, replacelanorix-server.exewith the new version, runstart-server.bat. - Moving to another computer: move the server folder together with
lanorix.db, open port 8787 and give the new computer the same IP address; the employees’ apps will then connect without reconfiguration. If the address changes, employees need to enter the new one in “Connection settings…” (“Настройки подключения…”). - Forgotten admin code: stop the server and run
lanorix-server.exe --reset-admin; your data is kept and a new code is issued.
11. Troubleshooting
- Employee computers cannot find the server: is the administrator’s computer on? Is Lanorix allowed on private networks in the firewall? Are the computers on the same subnet? If not, sign in via “Other options” with the address from the console or the tray menu (port 8787). Details are in the “Server log” (
server.log). - You need the admin code (to sign in from a browser or via “Other options”): it is saved in
%APPDATA%\Lanorix\server\admin-code.txt. For a dedicated server, see section 10. - “Invalid server key” (“Неверный ключ сервера”): the key was mistyped or has been revoked. Create a new one in the dashboard and paste it in full, including the
npk_prefix. - The vault does not open in the browser: encryption in the browser works only over HTTPS or on localhost. Open the console at a secure address or in the app.
- For other cases, see Common problems and solutions or contact support.