1.3. Installing and starting the server has been edited by Emmanuel Lécharny (Feb 24, 2009).

(View changes)

Work in progress

This site is in the process of being reviewed and updated.

Installing and starting the server

This section describes how ApacheDS can be installed and started at different platforms.


  • Java 5.0. We recommend using Sun's JDK , but the server has also been successfully tested with JRockit 5.0 and with IBM Java 5.0.
    You can check your java installation with:
    java -version

    this should response something like:

    java version "1.5.0_06"
    Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_06-b05)
    Java HotSpot(TM) Client VM (build 1.5.0_06-b05, mixed mode)
  • using Linux: you must have a X11 graphical interface
  • 384 MB RAM for the JVM. That's the default setting, how to change that is described here

Downloading the server

We provide native installers for several platforms:

  • MacOS (jar)
  • Solaris SPARC (jar)
  • Solaris i386 (jar)
  • Windows (exe)
  • Debian package
  • RPM package
  • Linux (jar)

You can download them from here.

An option for people familiar with tools like Subversion and Maven is to built the server from the sources on their own. This is described here.

Installing as Windows service

Installing can be easily done using the Windows installer. Its interface and functionality is similar to other wizard based installers.

To install the ApacheDS as Windows service you need Administrator privileges.

Starting and Stopping the server

The server can be started and stopped with the Service Configuration Manager (Programs -> apacheds -> Service Settings). You must be admin to do this.

The Service Configuration Manager also allows the configuration of several windows service settings such as:

  • Changing the display name & description of the service
  • Configuring the service startup type of Manual, Automatic, or Disabled
  • Changing the user the service runs as
  • Changing logging settings for the service
  • Changing the version of the Java Runtime used by the service
  • Changing the properties for the JVM

For details look at the next page 1.4. Basic configuration tasks

Installing on Linux

This is not up to date !

If you want to install ApacheDS as daemon in /etc/init.d, you need root privileges.
There are many posibilities installing ApacheDS on Linux:

  • using the Debian package
  • using the RPM package
  • using the Solaris package
  • or using the standard binary file

Using the binary file

// Get the apacheds Linux binary, and copy it where you want the server be installed.
chmod u+x apacheds-1.5.4-i386.bin

You will get a list of proposed installation directories that you can change. Remember that you must be root to be able to install the server correctly.

Starting and stopping the server

After installing the application there is one step left to start the server:

[root]# /etc/init.d/apacheds start


[user]# /usr/local/apacheds-1.0.0/bin/server.init  start

Stopping the server works equivalent

[root]# /etc/init.d/apacheds stop


[user]# /usr/local/apacheds-1.0.0/bin/server.init  stop

Powered by Atlassian Confluence (Version: 2.2.9 Build:#527 Sep 07, 2006) - Bug/feature request

Unsubscribe or edit your notifications preferences