Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Why at all

The Eclipse installer comes with its predifined set of available products and projects. It is fairly easy to add your own project setups locally, but what if you want to ship setups for a team of developers. Maybe they are not supposed to choose any version of Eclipse and they should not see all hosted projects, but only those you want...

This sample project is intended to give a first idea how this could be done. The key point is that you can tell the Oomph installer where to look for its models. If you take a look at the run configurations shipped with the Oomph project source code, you will notice the start parameter "-Doomph.redirection.setups".

How to try it out

Start the installer with the additional command line parameter:

-vmargs "-Doomph.redirection.setups=>"

or add the following line to the installer's oomph.ini


That way both product and project catalog are replaced.

The common prefix may be abbreviated by index:/

** Note that the index the sample project is based on is rather old. It still works, but in case you want to set up your own index, you should grab a current snapshot copy of the sources.**

What was changed wrt to the original

As a proof of concept, I started with the initial setups, renaming the project and product setup files. I stripped the products to contain only the Eclipse Standard/SDK and replaced projects in the project catalog by my own set. The org.eclipse.setup file could not be renamed, as the installer actually tries to locate a file of that name as a starting point. Other name tags were left intact as well, so that the variable logic with respect to the User setup would not break.

Redirecting the project catalog only

Replacing the project catalog only is not as simple. Running the installer with the following parameter looks good at first -Doomph.redirection.projectCatalog=> but unfortunately, it does not work. You will notice that project setups pointed to relative to the project catalog are not resolved correctly. The others will not be installed as the eclipse installation created by the installer is missing the redirecting start parameter, so the project setup to be installed will not be found, once the base installation is materialized.

See the projectCatalogRedirection branch for an attempt to overcome these problems.

Redirecting the index root file rather than the entire index directory

does not work. Hosting only a modified org.eclipse.setup and not the entire directory will fail (eventually). The wizzard looks fine and the installation process starts promisingly, but the new Eclipse instance will be missing the redirection to your own org.eclipse.setup file. This cannot be fixed, as defining an eclipse ini task is not supported by that setup type.

A starter for authoring your own project setups

Learn (and copy) from examples - they are at your finger tips! Use Navigate->Open Setup->Parent Models->Open Catalog Index. Here you have a resolved tree of all products and projects "hosted" by Oomph. Copy single tasks or whole model subtrees to your setup file.

Use Context Menu->Open in Text Editor on a catalog to see where the project setups are actually hosted (and how references can be used). Using the same method you have access to the pointers to your user projects (and you can modify and delete entries).

Also have a look at


oomph installer product and project redirect example






No releases published


No packages published