[LINUX] VRS X Setup Guide

Pre-start checklist

Before

1. Makewaking the Linux beast, make sure your OSsystem hasmeets kernelthe basic requirements:

   1. Kernel 5.0 or newer

      Check it with:

      uname -r
      

   2. Make sure

      OpenSSL 1.1.1 or OpenSSL 3.0+x (supportingwith TLS 1.2/1.3)3 issupport

      installed.

      Check it with:

      openssl version
      

   ---

   SudoNo issudo not necessaryneeded to startrun VRSVRSX. XSudo up,enters butthe tochat setonly upfor systemd servicesystemd.

   1. Download the Linux zip filepackage from the link givenprovided in the e-mail, for exampleexample:

      linux-arm64.zip
      

      Use the linux-arm64 package for ARM64 machines, for example Raspberry Pi 4/5 or other ARM64 devices.

      Use the linux-x64 package for Intel/AMD 64-bit machines.

   2. Unzip the filepackage:

      using command

      unzip linux-arm64.zip
      

      (or -x64 if

      Or, on Intel/AMD machine)machines:

      unzip linux-x64.zip
      

   3. Enter the directoryextracted usingdirectory:

      command

      cd linux-arm64
      

      (or -x64 if

      Or, on Intel/AMD machine)machines:

      cd linux-x64
      

   4. Make the binary executableexecutable:

      using command

      chmod +x VRSX
      

   5. Start itVRSX.

      up:

      Desktop mode:

      ./VRSX
      

      for

      Headless desktopmode:

      version,

      ./VRSX --headless
      

      for headless mode
   6. Enter

      Open VRSX in your browser:

      http://IP.OF.YOUR.MACHINE:8085
      and

      provide

      Example:

      licence

      http://192.168.100.100:8085
      

   7. Activate VRSX using the license key providedavailable under the “My Account” section in anADS-B.Pro emailRadarView.

   Your instance is ready to go!

   ---

   Set up a systemd service, sudo is necessary!necessary here

   Assuming,If you want VRSX to start automatically after boot, you can create a systemd service.

   The example below assumes:

   • your Linux username is youruser
   • VRSX is located in /home/youruser/linux-arm64
   • you are running the ARM64 version

   If you are using Intel/AMD, replace linux-arm64 with linux-x64.

   If your username is not youruser, replace youruser user on machine and VRS X is unzipped intowith your homereal directory,Linux forusername.

   example

   To check your username, run:

   /home/youruser/linux-arm64/,whoami
   you

   can

   ---

   simply follow

   Create the instructionsservice below,file

   but

   Open overwrite youruser` with a real username in your OS

   1. Create a systemdthe service file sudoin touchnano:
      /etc/systemd/system/vrsx.service
   2. Copy and paste the service configuration using for example nano (

      sudo nano /etc/systemd/system/vrsx.service
      :

   Paste the configuration below:

   [Unit]
   Description=VRSX
   After=network.target
   
   [Service]
   Type=simple
   User=youruser
   WorkingDirectory=/home/youruser/linux-arm64
   ## change to linux-x64 if you are on Intel/AMD machine
   ExecStart=/home/youruser/linux-arm64/VRSX --headless ## change to linux-x64 if you are on Intel/AMD machine
   
   # If your system is RHEL-based, for example Rocky Linux/CentOS, please remove ExecStart line above and uncomment the line below to avoid issues with SELinux:
   # ExecStart=/bin/bash -c '/opt/linux-x64/VRSX --headless'
   Restart=on-failure
   RestartSec=5
   
   [Install]
   WantedBy=multi-user.target
   

   OnceBefore done,saving, clickmake sure you changed:

   youruser
   

   to your real Linux username.

   If you are using the x64 version, also change:

   linux-arm64
   

   to:

   linux-x64
   

   Save and exit nano:

   Ctrl+O
   (save),Enter
   Ctrl+X
   (exit)
   

   WARNING: Old Linux jokejoke:: If you want to create a strong admin password, try to editediting this file usingwith vi, LOL..

   ---

   3. Make sure you have overwritten youruser with your username

      Enable and removedstart allthe commentsservice

      (after ##)

   4. Reload systemdsystemd:

      using command

      sudo systemctl daemon-reload
      

   5. Start

      Enable VRSX at boot and enablestart VRSit Xnow:

      service using command

      sudo systemctl enable vrsx --now
      

   6. Visit

      Check service status:

      sudo systemctl status vrsx
      

      If everything looks good, open VRSX in your VRSbrowser:

      X instance on port

      http://IP.OF.YOUR.MACHINE:8085
      (i.e.

      Example:

      http://192.168.100.100:8085)8085
      and

      activate

      Activate itVRSX using the licencelicense key givenavailable inunder "MYthe Account"“My Account” section in ADS-B.Pro RadarView

   RadarView.

   ---

   RHEL, Rocky Linux, CentOS and SELinux notes

   On some RHEL-based systems, SELinux may complain harder than a Windows admin forced to use a terminal.

   If the regular ExecStart line does not work, you can try wrapping the command in Bash.

   Replace this line:

   ExecStart=/home/youruser/linux-arm64/VRSX --headless
   

   with:

   ExecStart=/bin/bash -c '/home/youruser/linux-arm64/VRSX --headless'
   

   Then reload and restart the service:

   sudo systemctl daemon-reload
   sudo systemctl restart vrsx
   

   Check the logs if something still refuses to cooperate:

   journalctl -u vrsx -e
   

   Or follow logs live:

   journalctl -u vrsx -f
   

   ---

   Useful service commands

   Start VRSX:

   sudo systemctl start vrsx
   

   Stop VRSX:

   sudo systemctl stop vrsx
   

   Restart VRSX:

   sudo systemctl restart vrsx
   

   Disable VRSX from starting at boot:

   sudo systemctl disable vrsx
   

   View logs:

   journalctl -u vrsx -e
   

   Follow logs live:

   journalctl -u vrsx -f