---
updatedAt: 2025-10-20T19:25:40.000Z
agentTools:
  projectIndex: https://support.neurala.com/llms.txt
---

# Installing VIA

# :clipboard: 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.

# :white\_check\_mark: System Requirements

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

<Table align={["left","left"]}>
  <thead>
    <tr>
      <th>
        Specification
      </th>

      <th>
        Requirement
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        Operating System
      </td>

      <td>
        Windows 10 or Windows 11

        Ubuntu 22.04 or 24.04
      </td>
    </tr>

    <tr>
      <td>
        GPU
      </td>

      <td>
        Nvidia GTX 900 series or better, with a minimum of 6GB of video RAM

        Nvidia's 50xx-series GPUs are _not_ currently supported by Neurala applications.

        *Note that there are versions of the VIA applications that are optimized to run**without** a GPU. *
      </td>
    </tr>

    <tr>
      <td>
        CPU
      </td>

      <td>
        Intel i7 or better, at least 2GHz
      </td>
    </tr>

    <tr>
      <td>
        Memory
      </td>

      <td>
        16GB RAM
        32GB Storage

        _Neurala recommends a solid-state or high speed hard drive for best performance._
      </td>
    </tr>

    <tr>
      <td>
        Camera Interface
      </td>

      <td>
        GigE Vision Standard
        USB3 Vision
      </td>
    </tr>

    <tr>
      <td>
        Image Type
      </td>

      <td>
        Color/Monochrome
      </td>
    </tr>

    <tr>
      <td>
        Pixel Format
      </td>

      <td>
        Mono8
        Bayer BG8
        Bayer GB8
        Bayer RG8
        Bayer GR8
      </td>
    </tr>

    <tr>
      <td>
        Number of cameras
      </td>

      <td>
        VIA 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.
      </td>
    </tr>

    <tr>
      <td>
        Communication Protocol
      </td>

      <td>
        Modbus TCP
        Ethernet/IP
      </td>
    </tr>
  </tbody>
</Table>

## 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.

# :key: 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.

<Callout icon="⚠️" theme="warn">
  The Neurala VIA partner integration with AITRIOS by Sony uses a software license file in place of the USB license key. Please refer to the [VIA for AITRIOS](https://support.neurala.com/docs/via-for-sony-aitrios) documentation page for additional information.
</Callout>

## 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) | Processor | Includes                                                                                            |
| :------------- | :-------- | :-------------------------------------------------------------------------------------------------- |
| VIA            | GPU       | Brain Builder and Inspector applications for computers with a compatible GPU                        |
| VIA            | CPU       | Brain Builder and Inspector applications for computers with a compatible CPU. Does not use the GPU. |
| Inspector-only | GPU       | Installs only Inspector, for computers with a compatible GPU                                        |
| Inspector-only | CPU       | Installs 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

# :hammer: 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.

# :construction: 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 <support@neurala.com> so that the Neurala team can look into the issue in more detail.

# :no\_entry\_sign: Uninstalling VIA

For instructions to remove the VIA software, see this page: [Uninstalling VIA](https://support.neurala.com/docs/uninstalling-via)