HomeDocumentation
Log In

Installing VIA

πŸ“‹ Installation checklist

Before installing the VIA software on your computer, please review the details on this page to ensure you have all of the appropriate files and materials.

  • Does your computer meet the minimum hardware requirements?
  • Do you have the USB license key or license file?
  • Do you have the camera license file?
  • Do you have the correct VIA installation package?

When you have confirmed all of these details, you can proceed with the installation.

βœ… System Requirements

The Neurala VIA software requires a system with the following specifications:

SpecificationRequirement
Operating SystemWindows 10 or Windows 11
Ubuntu 20.04 or 22.04
GPUNvidia GTX 900 series or better, with a minimum of 6GB of video RAM
Note that there are versions of the VIA applications that are optimized to run without a GPU.
CPUIntel i7 Coffee Lake or better
Memory16GB RAM
32GB Storage
Camera InterfaceGigE Vision Standard
USB3 Vision
Image TypeColor/Monochrome
Pixel FormatMono8
Bayer BG8
Bayer GB8
Bayer RG8
Bayer GR8
Number of camerasVIA supports up to four cameras running simultaneously. If using more than two cameras at a time, Neurala recommends a high-performance NIC (e.g. Intel Pro/1000) with a dedicated port for each camera.
Communication ProtocolModbus TCP
Ethernet/IP

Clean computer

Neurala recommends installing VIA on a dedicated computer that is not used for any other applications. This is to ensure the VIA software can fully leverage the available processors and memory to provide consistent performance during inspections.

The computer should be set up with a clean installation of the operating system and with up-to-date drivers for the GPU.

πŸ”‘ License Keys

USB license key

Each computer running the VIA software must have a license key inserted into an available USB-A port on the computer. The license key is provisioned with an expiration date according to the agreement between the customer and Neurala. If the license key is not inserted, or if the license key has expired, the VIA applications will not operate.

License keys may be obtained by contacting your Neurala account representative or channel partner.

⚠️

The Neurala VIA partner integration with Sony AITRIOS uses a software license file in place of the USB license key. Please refer to the VIA for SONY AITRIOS documentation page for additional information.

Camera license file

The VIA software also requires a license file to properly receive image frames from a connected camera. If this license file is not correctly installed, then images from the camera will display a watermark.

The camera-related license file is tied to the MAC address of the computer on which the VIA software is running. To find your computer's MAC address, open a command prompt or terminal window and type ipconfig /all . The output will include the MAC addresses associated with your computer in the format of A1:B2:C3:D4:E5:F6. Please provide this to Neurala or your integration partner so that the camera license file can be generated for your computer.

To install the camera license file, place it into the following directory on your hard drive after the VIA software has been installed: C:\Program Files\Pleora Technologies Inc\eBUS SDK\Licenses.

πŸ“¦ Installation packages

There are different VIA installation packages that may be used depending on the details of your setup and planned workflow.

Application(s)ProcessorIncludes
VIAGPUBrain Builder and Inspector applications for computers with a compatible GPU
VIACPUBrain Builder and Inspector applications for computers with a compatible CPU. Does not use the GPU.
Inspector-onlyGPUInstalls only Inspector, for computers with a compatible GPU
Inspector-onlyCPUInstalls only Inspector, for computers with a compatible CPU. Does not use the GPU.

πŸ‘

Partner integrations

There are versions of the VIA applications that have been optimized for use with specific partners. They may have their own installers and system requirements.

See the Partner Integrations section for more information

πŸ”¨ Installation process

Windows

To install VIA applications on Windows, follow these steps:

  1. Place the installation file on the computer in a convenient location, such as the desktop or downloads folder.
  2. Double click the installer to start the installation process.
    • Note that Windows may open a warning prompt asking for confirmation before running the installer. Click "Run anyway" to continue.
  3. The installation wizard will guide you through the steps to install the software.
  4. The wizard will notify you when the installation is complete. After successful installation, the icons for Brain Builder and Inspector can be located in the Start Menu and on the Desktop.

Linux

To install the VIA applications on Linux, follow these steps:

  1. Place the installation file in a convenient place on the computer where the VIA software is to be installed.
  2. Run the Linux installer by running the following commands in a terminal window:
    $ chmod +x NeuralaVIA-filename.run $ ./NeuralaVIA-filename.run
    Note that "NeuralaVia-filename.run" should be replaced by the specific filename of the VIA installation file.
  3. The installation wizard will guide you through the software installation process.

🚧 Installation troubleshooting

Software conflicts

When installing VIA on a production computer, Neurala recommends using a dedicated PC with a clean installation of the operating system and updated drivers. When this process is followed, errors during installation are extremely rare.

If it is necessary to install VIA on a computer that is not a clean system, then the VIA installation may fail due to conflicts with other applications. If this occurs, the following actions are recommended:

  • Review the list of installed applications on the computer. If there are any other computer vision applications installed, remove them using the system's Uninstall Applications function.
  • Look for instances of "eBUS" or "Pleora Technologies" software on the computer. These are supporting applications that are used by multiple vision systems providers. If they have been installed as part of a different application, the VIA software may not install properly. Uninstall these applications before installing VIA.

Permissions

The VIA installation process requires administrative access to the computer. Before installing VIA, log into the computer as a user with full administrative privileges.

Installation logs

If the installation fails after reviewing the above details, navigate to the directory C:\Users\<user>\AppData\Local\Temp and locate the log files starting with NeuralaVIA-. Zip the collection of log files into a single archive and email them to [email protected] so that the Neurala team can look into the issue in more detail.

🚫 Uninstalling VIA

To remove the VIA software, complete the following steps:

  • In Windows, open the "Add/Remove Programs" system page, locate Neurala VIA, and click Uninstall. This will open the installation wizard, which will include an Uninstall option. Follow the steps to uninstall the applications.
  • In Linux, open a terminal window, and run ./NeuralaVIA-xyz.run -- --uninstall. This will activate the uninstallation process. (Replace "NeuralaVIA-xyz.run" with the name of the installer file.)

Uninstalling VIA with the wizard will leave some data and settings file on the computer. To permanently remove these files, do the following:

  • In Windows: find and delete the C:\ProgramData\Neurala and C:\Program Files\Neurala folders.
  • In Linux, run sudo rm -rf /var/Neurala /var/log/Neurala /opt/Neurala from the terminal.

What’s Next