Welcome to Semarchy.

In this tutorial, you will learn how to set up the Semarchy xDI Designer. After this setup, you will be able to run the data integration tutorials available on the Semarchy website.

What you'll learn

What you'll need

High-level architecture

The Semarchy xDI architecture includes the following components:

This tutorial is dedicated to installing Semarchy xDI Designer. The Designer embeds a local Runtime for running the data flows you will design in the other Semarchy xDI tutorial units.

System requirements

Before you proceed with the installation of Semarchy xDI Designer, review the system requirements in the online documentation.

In the next section, you will download and install the Designer.

In this step, you will download Semarchy xDI Designer and install it on your local machine.

Download the Designer

Download the latest version of the Semarchy xDI Designer from the Semarchy website. The Designer is shipped as an archive file available for Windows, Linux, and macOS.


Install the Designer

The installation process depends on your operating system.

Install the Designer on Windows

To install and run Designer on Microsoft Windows, uncompress the archive file to a temporary folder and copy its contents to your Program Files folder or to another folder.

Install the Designer on Linux

To install and run the Designer on Linux:

  1. Uncompress the archive file to a temporary folder and copy its content to your user folder.
  2. Go to your user folder and set the execution permission on the semarchy-xdi-designer-linux file.
chmod +x semarchy-xdi-designer-linux

Install the Designer on macOS

To install and run the Designer on macOS, uncompress the archive file to a temporary folder and copy the application in that temporary folder to your Applications folder. Once you have downloaded the correct archive for your computer's architecture, please run the following commands:

xattr -dr com.apple.quarantine semarchy-xdi-designer-macos*.tar.gz
tar xf semarchy-xdi-designer-macos*.tar.gz


Great job! You have installed xDI Designer on your computer. In the next step, you will run the Designer.

This step explains how to start and set up the Designer.

  1. Run the Designer:
  1. In the Semarchy xDI Designer Launcher dialog, select a folder that will contain your Workspace, then click Launch.

  1. The setup wizard opens. Click Next.

  1. Read the Semarchy End-User License Agreement, select I have read and agree to the license agreement, and then click Finish.

  1. The Trial License dialog opens. Click Close.

  1. The Welcome perspective opens. Click Hide to close the Welcome perspective and access the Workbench.

  1. The Designer workbench opens:

xDI is now up and running. You can find in the documentation more information about advanced Designer configuration.

In this section, you will learn how to register your Semarchy xDI license in the Designer.

  1. In the Help menu, select Manage License.

  1. The License Manager opens. Click Register.

  1. The Register License dialog opens. Select and configure your license:

If you are using a License Key File (Offline mode):

If your license is provided by a local server (Local Server mode):

If your license was obtained from the Semarchy License Server (Online mode):

  1. Click Register. Your license status is updated on the License Manager.

Congratulations! You have successfully registered your Semarchy xDI Designer instance.

Congratulations! You learned how to install and register Semarchy xDI Designer.

What we've covered

What's next?

The next step is to follow the Semarchy xDI - Data Integration tutorials, starting with the Create Your First Data Flow with Semarchy xDI unit.

Go back to the main menu to find these tutorials.