Setup your Build Environment for more than one project

Let's assume you have a Yanel project for client A (e.g. retail shop website/realm) and another project for client B (e.g. classic car website/realm).

Now you have several options how to set this up:

  1. Run each project/realm from a separate Yanel instance
  2. Run both projects/realms from the same Yanel instance, hence add both realm configurations to your YANEL_HOME/conf/local/local.realms.xml
  3. Run one Yanel instance, but use two different local.realms.xml configurations and switch from one to the other


1) More than one Yanel instances

This setup does not really make sense if you work on more than one realm, but rather for developers working on more than one Yanel core component in order to avoid conflicts.

2) One Yanel instance with multiple realms

For most cases this is the recommened setup.

3) One Yanel instance, but two different configurations

First add some folders for you projects. just add within your conf/local a folder for each project e.g.:


then you need to add local.configs for each of your projects e.g.:


best you copy the original configs in your conf/ folder and modify it accordingly to your projects.

To switch between the different project-configs add your projects in your src/build/

# Dir name of local configuration

now you can switch between the different project by commenting out some of them.

Your comments are much appreciated

Is the content of this page unclear or you think it could be improved? Please add a comment and we will try to improve it accordingly.