Turnus is Java based tool and it uses Maven as its build tool.

For the GUI part of Turnus you need also Eclipse IDE.

You will need to have the following installed on your system:

1. Java Development Kit (JDK)
2. Apache Maven
3. Eclipse IDE for UI and development

1. Use at least JDK-17
2. Follow the installation instructions for your operating system.
3. Verify the installation by running the following command in your terminal:

   java -version

   You should see output indicating the installed version of Java.

1. Download the latest version of Maven from the Maven download page. Or from your package manager.
2. Follow the installation instructions for your operating system.
3. Verify the installation by running the following command in your terminal:

   mvn -version

   You should see output indicating the installed version of Maven.

Once you have both Java and Maven installed, you can proceed with building Turnus.

1. Open the settings.xml file located in the Maven conf directory (usually ${user.home}/.m2/settings.xml).
2. Add the following configuration inside the <proxies> tag:

   <proxies>
     <proxy>
       <id>example-proxy</id>
       <active>true</active>
       <protocol>http</protocol>
       <host>proxy.example.com</host>
       <port>8080</port>
       <username>proxyuser</username>
       <password>somepassword</password>
       <nonProxyHosts>www.google.com|*.example.com</nonProxyHosts>
     </proxy>
   </proxies>

3. Replace the placeholder values with your actual proxy details.
4. Save the settings.xml file.

This configuration will allow Maven to connect to the internet through the specified proxy.

Turnus uses Eclipse EMF as its core and is strongly related to the version of Eclipse.

The latest version of Turnus is 2023.6 and its associated version of Eclipse 2023-06.

1. Use Eclipse 2023-06 and download the Eclipse IDE for Java and DSL Developers for your operating system and CPU architecture.
2. Decompress the archive to a chosen location.
   • You can use any file decompression tool available on your operating system.
3. Open Eclipse and install 'Graphiti SDK' from:
   • Navigate to Help -> Install New Software.
   • In the Work with field, enter the update site URL for Graphiti SDK, choose 2023-06.
   • Select Graphiti SDK from the list and follow the prompts to complete the installation.

To build Turnus from the command line, follow these steps:

1. Clone the repository from GitHub:

   git https://github.com/turnus/turnus.git

2. Navigate to the main folder of the project:

   cd turnus

3. Execute the following command to build the project:

   mvn install

This will compile the project and install the necessary dependencies.

1. From the menu bar:
   • Window -> Show View -> Project Explorer
2. Right-click on the empty Project Explorer space and select Import...
   • On the Import Wizard select Maven -> Existing Maven Projects
   • Click Browse... and select the folder where Turnus was cloned
   • Click on Select All and then Finish
3. Right-click on turnus.core project and then Run As -> Maven Install
4. After a while if the build is successful Eclipse will print on the Console window

    ...
    ...
    [INFO] BUILD SUCCESS
    ...

5. Right-click again on turnus.core project and then Maven -> Update Project...
   • Click Select All and then OK

After this step your development environment for Turnus is ready. For lunching eclipse follow the step on Lunching page.