Lanorix server on Linux: SSH install and update
The “Install server on Linux” wizard (Ubuntu 22.04/24.04, Debian 12): requirements, what the install does, confirming the server key, SSH key removal and the “Update server” button.
The Lanorix server can be installed on a separate Linux computer or virtual machine straight from the administrator app, with no command line. The wizard connects over SSH, installs and starts the server, connects your console to it and, if you wish, moves the data from the built-in server.
The Lanorix app may show its interface in Russian. Where it helps, the original Russian label is given in parentheses.
Requirements
- The Linux computer: Ubuntu 22.04 or 24.04, or Debian 12; an x86_64 or arm64 CPU; systemd; a running SSH server (the
openssh-serverpackage) reachable from your network (SSH port 22 by default). - A user with sudo rights (or root) and their password.
- On the administrator’s computer: Windows 10/11 with the “OpenSSH Client” feature (usually on already). If not: Windows Settings → Apps → Optional features → Add a feature → “OpenSSH Client”.
- Internet on the Linux computer is needed only if it has no Node.js 22.13 or newer: the installer then downloads it from nodejs.org and verifies the checksum.
- Reserve the Linux computer’s IP in the router so the address does not change.
- Only the company owner can move data to the new server.
Installing step by step
- In the console open “Settings” → “Backups and server” (“Копии и сервер”) and click “Install server on Linux…” (“Установить сервер на Linux…”).
- Fill in: Computer address (IP or name), Linux user, SSH port, the user’s password. The password is used once, for sign-in and for sudo, and is never stored.
- Three checkboxes:
- “Move data from this computer to the new server”: shown only if you have built-in server data. Computers, zones, requests and the log are copied and employee PCs switch by themselves. If anything goes wrong, the server on your computer keeps running as before.
- “Issue a new admin code”: tick it only if a server was already installed on this Linux computer before; the old code stops working.
- “Keep SSH access for maintenance”: off by default (see below).
- Click “Next”. If the OpenSSH client is missing, the wizard tells you how to enable it.
- Confirm the server key. The wizard shows the computer’s SSH key fingerprint (for example
SHA256:…) and key type. This protects against impersonation: make sure you are connecting to your own server. On the Linux computer runssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub; the fingerprint must match. If you have no way to compare, and the computer is in your office network and you have just switched it on yourself, you can continue. Click “Fingerprint matches, continue” or “This is not the right server” to stop. - Follow the list of steps (✓ marks): OpenSSH check, server key check, temporary key, sign-in, system and rights check, file transfer, installing and starting the service, secure connection check, connecting the console, data move, closing SSH access. “Detailed log” at the bottom helps if something fails. A running install can be stopped with “Cancel”.
- At the end you see “Server installed and running”: the server address and version, the admin code (shown once, save it: it is needed to sign in from another computer and from a browser) and an invitation for employee PCs. Copy them with the buttons and click “Done”.
What the install does
- Checks the system (Ubuntu 22.04/24.04 or Debian 12, x86_64/arm64, systemd) and sudo rights.
- Installs Node.js 22 if needed (with a checksum check).
- Creates a system user
lanorixwith no login; the server code goes to/opt/lanorix-server(owned by root, so the service cannot change it) and the data to/var/lib/lanorix-server(thelanorix.dbdatabase). - Verifies the signature of the server package and registers the systemd service
lanorix-serverwith autostart. - If
ufwis enabled, opens 8787/tcp and 8788/udp. Ifufwis not enabled, ports are not changed; with an external firewall (hosting, router) open them yourself. - Issues the admin code and creates a reusable invitation for employees (see “Invitations for employees”).
Running the wizard again is safe: it updates files and restarts the service without touching data or the certificate.
The SSH key: what happens to it
The wizard creates a temporary ed25519 key in the app’s data folder (accessible only to your Windows account) and adds it to the Linux user’s ~/.ssh/authorized_keys with a lanorix-admin-… label. At the end of the install the label is removed from the server and the private key is erased from your computer: the “Closing SSH access” step. If you ticked “Keep SSH access for maintenance”, the key stays (the ssh folder in the app data). If the key could not be removed, the log shows the label: delete that line from ~/.ssh/authorized_keys by hand. The wizard does not use your own ~/.ssh settings.
After the install
- The console is already connected to the new server. From another computer sign in with “Other options” → “Administrator” → the server address (
192.168.1.50:8787) and the admin code. - Connect employees with the invitation (“Connect by invitation”), or they find the server themselves if they are in the same subnet (UDP 8788).
- Backup: copy
/var/lib/lanorix-server/lanorix.db, or better use the backups in “Backups and server”.
Updating a Linux server
A Linux server is updated from the app, without SSH. The new server version ships inside the Lanorix app on your computer, so update the app itself first (see “Changing server, signing out, uninstalling”).
- Open “Settings” → “Backups and server”, the “Server and employees” block.
- If the Linux server is older than the version in the app, a line “Server … can be updated to …” and an “Update server” (“Обновить сервер”) button appear. Click it and confirm.
- The server restarts for a few seconds and employee computers reconnect by themselves.
The server verifies the update’s digital signature and accepts only a newer version; if the new version fails to start three times, it automatically goes back to the previous one. The button is hidden if the server is not a Linux service, is already up to date, or the package in the app is not signed.
Troubleshooting
- “OpenSSH client not found”: enable the “OpenSSH Client” feature in Windows (see above) and retry.
- “Could not resolve this address” / “SSH error”: check the address and port; the SSH server must be running on the Linux computer (
sudo systemctl status ssh) and be in the same network. - “User … has no sudo rights (or the sudo password was wrong)”: use root or a user from the sudo group and check the password.
- “System … is not supported”: Ubuntu 22.04/24.04 or Debian 12 is required.
- “The service did not respond within 40 seconds”: on the server run
sudo journalctl -u lanorix-server -n 50and send the output to support (without the admin code). - Employees cannot connect: open 8787/tcp and 8788/udp on the server (
sudo ufw allow 8787/tcp,sudo ufw allow 8788/udp) and check the router or hosting firewall. Automatic discovery works only within one subnet; for others use an invitation. - The invitation expired: create a new one in “Backups and server” → “Invite employees…”.
- SmartScreen warning when installing the app on Windows: the installer is not signed yet; check the SHA-256 and click “More info” → “Run anyway”.
If the wizard ends with an error, the server on your computer (if there was one) keeps running as before. For anything else see “Common problems” or contact support.