Download & Installation

eclipse-800x188

System Requirements

Faktor-IPS is based on the widely used Eclipse development platform. If you do not have the latest version of Eclipse, download it on Eclipse.org and unpack the directory. Start Eclipse now and install Faktor-IPS.

To install, drag this symbol to an open Eclipse workspace.

Installing Faktor-IPS

There are two ways to install Faktor-IPS: either directly in Eclipse (via update site or marketplace) or as manual download. The easiest option is to drag the CD icon next to this text onto the toolbar of an open Eclipse workspace.

Update Site (recommended)

Start Eclipse and make sure that internet connectivity is available. You may have to adjust the proxy server settings or other settings (Windows → Preferences → Network Connections).

  1. Start the Update Manager: Help → Install New Software…
  2. Enter the address of the update site: https://update.faktorzehn.org/faktorips/latest and press Enter to confirm.
      • If you would like to install any version of Faktor-IPS other than the latest, select the corresponding address from the Archive.
      • If you want to also install popular add-ons like m2e or product variants, use https://update.faktorzehn.org/faktorips/.
  3. Select the Faktor-IPS features for installation.
  4. Make sure there is a check mark next to “Contact all update sites during install to find required software.”
  5. Follow the steps of the Install Wizard and click “Next.”

Manual Installation

Select the download site for the desired version from the Archive. All plugin repositories, that is files containing “p2 repository” in the file name, are available on the download site. This plugin repository can be unpacked in the directory of your Eclipse installation. If the Eclipse installation does not contain a “dropins” directory, create a folder titled “dropins” directly under the “eclipse” directory.

Problems after the Installation

If after the installation not all Faktor-IPS plugins can be loaded, it may help to restart Eclipse with the added “-clean” parameter.

Further Information

Faktor-IPS consists of a collection of features/plugins for Eclipse. Eclipse needs to be installed before Faktor-IPS can be used and the selected Eclipse installation has to contain EMF/GEF “plugins.” The easiest option is to use Eclipse Modeling Distribution or the JEE distribution, since both already include EMF and GEF.

Overview of the Individual Faktor-IPS Features

(“feature” as used by Eclipse for separately installable units)

Feature name Feature ID Description
Faktor-IPS org.faktorips.feature Faktor-IPS in English
Faktor-IPS German org.faktorips.feature.nl1 German
Faktor-IPS source org.faktorips.feature.source Faktor-IPS source code

More features are available under Add-ons. When working with Maven, you should install the Faktor-IPS-m2e-Plugin.

Compatibility

While further developing Faktor-IPS, we try to ensure that Faktor-IPS is compatible with as many versions of Eclipse as possible. The latest available version of Faktor-IPS is always tailored to our customers’ needs.

The following list specifies for which Eclipse versions Faktor-IPS has been tested. Faktor-IPS does not support any versions of Eclipse older than the ones listed. New versions of Eclipse that are not explicitly listed are usually compatible with Faktor-IPS as well.

Faktor-IPS version Eclipse version Java version
Design time Runtime
Faktor-IPS 24.1 Eclipse 2022-12 – 2023-12 17/21 8/11/17/21
Faktor-IPS 23.6 Eclipse 2022-12 – 2023-06 17 8/11/17
Faktor-IPS 22.12 Eclipse 2020-03 – 2022-06 (NOT 2022-09 or later) 11/17 8/11/17
Faktor-IPS 22.6 Eclipse 2019-03 – 2022-06 11/17 8/11/17
Faktor-IPS 21.12 Eclipse 2019-03 – 2021-12 11/17 8/11/17
Faktor-IPS 21.6 Eclipse 2019-03 – 2021-06 11 8/11
Faktor-IPS 20.12 Eclipse 4.4 – 2020-12 8 6/8
Faktor-IPS 20.6 Eclipse 4.4 – 2020-06 8 6/8
Faktor-IPS 19.12 Eclipse 4.4 – 2019-12 8 6/8
Faktor-IPS 19.7 Eclipse 4.4 – 2019-09 6/8 6/8
Faktor-IPS 3.22 Eclipse 4.4 – 4.8* 6/8 6/8
Faktor-IPS 3.21 Eclipse 4.4 – 4.8* 6/8 6/8
Faktor-IPS 3.20 Eclipse 3.6 – 4.7* 6/8 6/8
Faktor-IPS 3.19 Eclipse 3.6 – 4.6* 6/8 6/8
Faktor-IPS 3.18 Eclipse 3.6 – 4.6* 6/8 6/8
Faktor-IPS 3.17 Eclipse 3.6 – 4.6* 6/8 6/8
Faktor-IPS 3.16 Eclipse 3.5 – 4.5 6 6
Faktor-IPS 3.15 Eclipse 3.5 – 4.5 6 6
Faktor-IPS 3.14 Eclipse 3.5 – 4.5 6 6
Faktor-IPS 3.13 Eclipse 3.5 – 4.4 6 6
Faktor-IPS 3.12 Eclipse 3.5 – 4.4 6 6
Faktor-IPS 3.11 Eclipse 3.5 – 4.3 6 6
Faktor-IPS 3.10 Eclipse 3.5 – 4.2 6 6

(*) From Eclipse 4.6 Neon and 4.7 Oxygen on please do not use the “Modelling Edition” because it contains plugin versions incompatible with Faktor-IPS.