Local NLS

nls-client and nls-server on the VCS host with a connection to Root NLS

bg-dots
bg-dots

Preferred production scheme: the same host as the Vinteo server runs nls-client and a local nls-server. The client obtains licenses from the local NLS (127.0.0.1), and the NLS connects to Root NLS.

Components:

  • Root NLS — Vinteo’s root network license server (root.nls.vinteo.dev);
  • nls-server — local on the VCS host;
  • nls-client — on the same Vinteo host.
Attention!
Activating the NLS in Root NLS and issuing the license pool is performed by technical support (support@vinteo.ru). Confirm Root NLS network addresses with support before adding them to a long-term allowlist.

See also: Choosing a licensing scheme, Dedicated NLS.

Requirements

Debian 13 requires the libengine-gost-openssl library. Agree the package and installation method with technical support if the library is not available in your repositories.

In production, the local nls-server connects to the production Root NLS. The configuration sets the full NLS name and the Root NLS address agreed with support (primary FQDN — root.nls.vinteo.dev).

Do not disable the local nls-server: the client on this host depends on it.

Installing nls-server

Step 1. Install the required dependencies (including libengine-gost-openssl), then the NLS server package:

apt reinstall nls-server-net

Step 2. Before activation, check /etc/vcs/nls/nls.conf:

  • IP_TCP_OUT — Root NLS address agreed with support;
  • NAME — the full name of your NLS.

Activating nls-server

Step 3. Start the NLS server:

systemctl start nls-server

The service may remain in a waiting state until confirmation in Root NLS. This is expected.

Step 4. Tell technical support the NLS name from the configuration. Support activates the server in Root NLS and issues the license pool.

Step 5. After licenses are issued, restart the service and enable autostart:

systemctl stop nls-server
systemctl start nls-server
systemctl enable nls-server

Registering nls-client

Step 6. On the same host, register the client with the local nls-server:

client -reg

In the wizard, provide:

  • encryption — 1 (GOST);
  • server — 127.0.0.1;
  • port — 4000;
  • host name — the VCS server name for which licenses are requested.

Step 7. Start the NLS client:

systemctl start nls-client

The client connects to the local NLS over TCP 4000.

Verification

systemctl status nls-server
systemctl status nls-client
network_license_server --version

Configuration:

cat /etc/vcs/nls/nls.conf
cat /etc/vcs/nls-client/default.conf

Logs:

journalctl -u nls-server -e
journalctl -u nls-client -e

NLS connection status and licenses are shown in the web interface under System → Licenses.

Choosing a licensing scheme Dedicated NLS