Guide - Development on Mac OS X

1 Introduction

This guide is intended for developers and describes how to set up an Intershop development environment on Mac OS X.

2 Database

You can either use Oracle or MS SQL Server.

2.1 Oracle

2.1.1 Oracle Database

Use the oracle database either in a VM, a docker container or use an external database.

2.1.2 Oracle Client

  1. Download the Oracle Client for Mac OS.
  2. Modify oracleClientDir in according to your environment.


    In case you get the error ORA-21561: OID generation failed when connecting to the database, edit the hosts file on the Mac to include a local computer name by adding the computer name to the end of the line.
    For example, the last line of the hosts file would read: localhost <local computer name>.

2.2 MS SQL

The following MS SQL docker container can be used:

2.2.1 Azure Data Studio

Azure Data Studio can be used as database tool, see Download and install Azure Data Studio:

Create Database
CREATE DATABASE intershop COLLATE Latin1_General_100_CI_AS;


Set the following
intershop.jdbc.url =jdbc:sqlserver://localhost:1433;database=db

3 Intershop Studio

To set up Intershop Studio on Mac:

  1. Download and install standard Eclipse for Mac.
  2. Go to Help | Install New Software.
  3. Select Intershop Studio Update Site:
  4. Install Intershop Studio Extensions

3.1 Additional Plugins

3.1.1 XText

3.1.2 Groovy Dev Tools

3.1.3 Xtend IDE

If you get an error message regarding org/eclipse/xtend/typesystem/MetaModel, you need to install the Xtend IDE:

3.2 JDK Used by Eclipse

Make sure that Eclipse is using the correct JDK by going to About Eclipse | Installation Details | Configuration, check for the -vm argument.

If the JDK version needs to be changed, follow this:

  1. Start Eclipse by double clicking the Eclipse application on MacOS.
  2. If you need to pass arguments to Eclipse,  edit the eclipse.ini file inside the Eclipse application bundle:
    1. Select the Eclipse application bundle icon while holding down the Control Key.
      A popup menu opens.
    2. Select Show Package Contents in the popup menu.
    3. Locate eclipse.ini file in the Contents/MacOS sub-folder and open it with your favorite text editor to edit the command line options.

3.3 Add the Cartridge Development Perspective

4 Increase Shared Memory

To increase shared memory:

  1. Edit /etc/sysctl.conf:

    Increase Shared Memory


    Increase Shared Memory
    #on each reboot
    sudo sysctl -w kern.sysv.shmmax=12582912
    sudo sysctl -w kern.sysv.shmall=12582912

5 Deployment

The packages for Mac OS X are now also published in the Intershop Repository under OS-Id darwin and they should be used automatically when deploying with gradle on a Mac:
platformId = darwin.x86_64

Mac-specific packages:

  • ivy-releases/com.intershop.infrastructure/runtime/3.0.3/zips/
  • ivy-releases/com.intershop.infrastructure/tcm/3.0.3/zips/
  • ivy-releases/com.intershop/3rd_apache/
  • ivy-releases/com.intershop/webadapter/1.0.10/zips/

In the command readlink is used, which does not exist on Mac OS X by default. However, this can be solved with the help of Homebrew :

  1. Use the following command:

    brew install coreutils
  2. Create an alias:

    alias readlink=greadlink

6 Set java.library.path (only 7.9)

To set the java.library.path:

  1. Edit and add JAVA_OPTS=$JAVA_OPTS\ -Djava.library.path=$IS_HOME/lib.

7 Webserver and Web Adapter

To start the web server:

Start web server
cd local/httpd/bin
sudo ./apachectl -k start

If you get the error message ./apachectl: line 73: ulimit: open files: cannot modify limit: Invalid argument, you can edit apachectl and replace:

ULIMIT_MAX_FILES="ulimit -S -n `ulimit -H -n`"



8 Start Application Server

To start the server:

Start server
cd server/local/bin
. ./

8.1 Application Server Start Using Eclipse

To start the application server using Intershop Studio's server view, the run configuration must be extended:

  1. Add the VM argument: -Djava.library.path="${IS_HOME}/lib" 
  2. Do the same for the debug configuration.
The information provided in the Knowledge Base may not be applicable to all systems and situations. Intershop Communications will not be liable to any party for any direct or indirect damages resulting from the use of the Customer Support section of the Intershop Corporate Web site, including, without limitation, any lost profits, business interruption, loss of programs or other data on your information handling system.
The Intershop Knowledge Portal uses only technically necessary cookies. We do not track visitors or have visitors tracked by 3rd parties. Please find further information on privacy in the Intershop Privacy Policy and Legal Notice.
Knowledge Base
Product Releases
Log on to continue
This Knowledge Base document is reserved for registered customers.
Log on with your Intershop Entra ID to continue.
Write an email to if you experience login issues,
or if you want to register as customer.