## Installing on Linux
This document explains how to install Visual System Integrator on Ubuntu Linux Host. The instructions might also work for other linux variants but we have only tested these instructions on Ubuntu Desktop 16.04 and Centos 7.9.

### Prerequisites

- Linux Kernel 4.x<sup>1</sup>
- Vivado Design Suite HLx Editions 2022.1: [Download here (registration required)](https://www.xilinx.com/support/download/index.html/content/xilinx/en/downloadNav/vivado-design-tools.html)
- Xilinx Vitis (Only required if it wasn't previously selected during Vivado Installation): [Download here (registration required)](https://www.xilinx.com/support/download/index.html/content/xilinx/en/downloadNav/embedded-design-tools.html)

### Instructions

#### Options
- Manually follow steps to download and install Visual System Integrator.

#### Running the Installer
1. Download the installation file from [Here](/get-started/locally/) (Make sure to choose the major version that corresponds to the Vivado version that is installed on the host)<sup>2</sup>
2. Open a terminal where the installer is, then run it as follows (where <<vsi_install>> is an install path of your choosing. You must have write privileges on install directory; if dir does not exist, it will be created):
	- `chmod +x vsi_xxxx.x_xxxx.run`
	- `./vsi_xxxx.x_xxxx.run --target <<vsi_install>>`
3. The following commands must be done in the shell where you will launch vsi:
	- `source <<vivado_install>>/settings64.sh`
	- `source <<vsi_install>>/settings.sh`
4. Optional: if you have already received your license, copy it to $VSI_INSTALL directory.
5. To launch VSI, execute the command `vsi`. If the installation was successful then you should see text similar to this:
	 ```

	Visual System Integrator version: V2022.1_Release_1.0, Compiler: "GNU - 6.5.0 20181026", Buildhost: "fulliautomatix.corp.systemviewinc.com - Linux-4.4.0-142-generic", Date: 2021-06-22T11:49:20

	```
4. If you don't see similar text then see [Troubleshooting](/docs/2018.2/troubleshooting)


#### Footnotes
1. Typically a modern linux distribution released within the last 5 years should work; we recommend Ubuntu 16.04 LTS (or newer) or Centos 7.6 (or newer)
1. Certain VSI features are only available on newer releases. For a feature comparison matrix, [look here](/docs/2022.1/features)