# Installation

Eclipse Xtext is implemented in Java, so you must have a Java Runtime Environment installed in order to proceed.

There are two easy ways to get Xtext up and running. A pre-configured Eclipse distribution is available which has already all the necessary plug-ins installed. Alternatively, you can install Xtext into your existing Eclipse by means of the Eclipse update mechanism.

## Install Pre-Configured Eclipse With Xtext

1. Go to http://xtext.itemis.com and select the distribution that matches your OS.
2. Unzip the archive into the directory of your choice. Windows Users should choose a directory close to the root since the zip contains a deeply nested folder structure. The maximum path length on windows may not exceed roughly 256 characters.
3. Launch Eclipse and select the workspace location. It is basically the location for your user data and project files and may be an empty directory.

## Install Xtext From Update Site

If you have no existing Eclipse installed, it is probably easier to choose a pre-configured Eclipse. Alternatively, you can go to http://www.eclipse.org and choose the Eclipse IDE for Java Developers. Find the download link that matches your platform and follow the installation instructions above to extract and launch Eclipse.

- Choose Help -> Install New Software... from the menu bar and Add... the following update site: http://download.itemis.de/updates/. This site aggregates all the necessary and optional components of Xtext.
- Select the Xtext SDK from the TMF Xtext category and hit Next until you can Finish the wizard.
- After a quick download and a restart of Eclipse, Xtext is ready to use.

Note: Xtext relies on the Antlr generator library. Unfortunately, we cannot provide this library on the official Eclipse release update sites. Instead, Xtext will try to download it on demand. To avoid this, you can manually install the feature Xtext Antlr-2.0.0 from the itemis update site (http://download.itemis.de/updates/). The general installation procedures are not affected by this issue.