Here is what you need to get started with Xsemble.


You need Java (JDK8 or JDK11) installed on your machine. Several providers provide these distributions under various license terms, and in principle you should be able to use any one of them. We use the OpenJDK 11 distribution which may be downloaded from here. (Look for 11 GA release.)

The installation is easy. In addition to extracting the binaries, make sure that the bin folder is included in your PATH environment variable, and set the JAVA_HOME environment variable to point to the path of where you extracted the release.

For Java Based Web Applications

Xsemble supports creation of Java based web applications. For this, you need a build tool named gradle. Download latest version of gradle and configure it as per the instructions on the same page.

Optionally, download Apache Tomcat server where you can run the created web application. Make sure you download version 9.*. (Do not take the latest version.) This is optional because there is a gradle plugin that can automatically download and use a Java web server. The process to do that is outlined in the User Guide that comes with Xsemble. Further, keep in mind that on Windows, the XAMPP server bundle contains tomcat, along with useful utilities such as MariaDB database and phpMyAdmin application which is used to manage that.

For PHP Based Web Applications

The new Xsemble3 may be used for creating PHP based applications. The build tool needed for PHP is composer. Follow these instructions to install composer on your system.

To run the web application created, you need a web server that supports PHP. Common choices are Apache2 and nginx. However, it is convenient to install the XAMPP bundle because that contains not just the Apache2 server but also other useful utilities such as the MariaDB database and phpMyAdmin application that is used to manage that. Use PHP version 7.4 or later.


Here is the primary download, the Xsemble distribution itself.

The new Xsemble3 extends support beyond the Java EE technology. You need a technology cartridge that supports the technology. While the Web and Java EE technology cartridges are included into Xsemble by default, a PHP technology cartridge is separately provided as an optional download. It will help you create PHP based web applications in addition to Java based web applications. It will also help you create applications containing mixed technologies, such as some microservices being implemented with Java EE and some with PHP.


Extract the downloaded Xsemble distribution archive in a folder. We shall call this folder the Xsemble Home.

In case you have downloaded any additional technology cartridges, add them to the ‘tech’ subfolder under Xsemble home. (If they are provided as zip files, then extract the contents of these files.)

Xsemble is configured through the file located in your Xsemble home. The default settings work for most users to let you launch Xsemble. But in case you face an issue, check out the ‘Onboarding and Configuration’ chapter under ‘Toolset Basics’ section in the Reference manual. The information on how to access the documentation is given below.

Launching Xsemble

Xsemble contains 3 desktop applications. They can be launched by running the launch scripts in Xsemble home. We recommend running them through the command prompt (terminal).

  • For Assembler’s Workbench, use (on Linux/Unix) or run-asm.bat (on Windows).
  • For Developer’s Workbench, use (on Linux/Unix) or run-dev.bat (on Windows).
  • For Monitoring Workbench, use (on Linux/Unix) or run-mon.bat (on Windows).

When Xsemble is launched for the first time, it presents a Registration dialog to you. Upon successful registration, a key that is unique to you and your machine is created and added to your Please preserve this key.

By default you get started with the FREE plan. To upgrade, contact us.

Accessing Xsemble Documentation

Xsemble comes with elaborate documentation in terms of a User Guide and a Reference Manual. The User Guide may be used as a Quick Start. For a detailed overview of concepts as well as explanation of every functionality, refer the Reference Manual.

If an Xsemble application is running, the documentation can be conveniently accessed through Help -> Contents.

The documentation can also be directly opened in the browser. For doing that, go to the doc folder under Xsemble home and double-click on index.html file under the html subfolder.