Advanced Nuclos installation: text-interactive install (-c), unattended install (-s) with XML configuration and changing the document path in nuclos.xml.

globe with meridians Language: Deutsch · English

hammer and wrench Advanced installation topics

Beyond the graphical installer: text-based and unattended installation plus later server adjustments.

On this page

Text-interactive installation

Without a GUI (e.g. over SSH) use the generic installer with -c:

java -jar nuclos-<version>-installer-generic.jar -c

If that fails, run it headless:

java -Djava.awt.headless=true -jar nuclos-<version>-installer-generic.jar

Unattended installation

For automated rollouts, pass the settings as an XML file and start with -s:

<?xml version="1.0"?>
<nuclos>
  <server>
    <home><!-- installation path --></home>
    <name><!-- instance name --></name>
    <http><enabled>true</enabled><port>80</port></http>
    <https><enabled>false</enabled><port>443</port></https>
    <shutdown-port>8005</shutdown-port>
    <heap-size>1024</heap-size>
    <java-home>/opt/java</java-home>
    <launch-on-startup>true</launch-on-startup>
  </server>
  <database>
    <adapter>postgresql</adapter>
    <connection-url>jdbc:postgresql://localhost:5432/postgres</connection-url>
    <username>nuclos</username>
    <password>nuclos</password>
    <schema>nuclos</schema>
  </database>
</nuclos>
java -jar nuclos-<version>-installer-generic.jar -s <path to config file>

To update an existing installation (> 3.0.0), use the existing <nuclos-home>/nuclos.xml as the config file.

Change the document path later

The document path can only be set on first install; during updates the field is disabled. If needed, do it manually:

  1. Change the path directly in nuclos.xml (<documentPath>).
  2. Run the installer/update – it takes the values from nuclos.xml.
  3. Copy existing documents into the new directory manually.

Related pages

rocket Installation (DE)


The guided installation path.

Öffnen →

memo Installation FAQ (DE)


Production, updates, HTTPS.

Öffnen →