GETTING STARTED

Download, install
and start running.
Under 10 minutes.

FlowCentral Convergence ships as a single, self-contained executable JAR. Install Java, extract the archive, run one command and you're in. No application server, minimal configuration.

BEFORE YOU BEGIN

Prerequisites.

FlowCentral Convergence runs on any modern Java runtime. Make sure the following is installed on your machine before proceeding.

Java JRE with JDK

A Java Development Kit (JDK) that includes the Java Runtime Environment (JRE). Any vendor - Oracle, Adoptium, Amazon Corretto, Azul Zulu - is supported.

Minimum version 1.8 (Java 8)

Supported OS

Windows or Linux. The JAR is platform-agnostic - as long as Java runs, FlowCentral Convergence runs.

Verify install java -version

Free Port

By default FlowCentral Convergence binds to port 8080. Make sure it is available, or change it in application.properties.

Default URL http://localhost:8080
THE FLOW

Six steps. That's it.

Follow the sequence below. Each step builds on the last — by step six you'll be logged into the Convergence Studio.

  1. 1

    Install Java (JRE with JDK)

    Install a Java Development Kit that includes the runtime. The minimum supported version is Java 1.8. After installation, open a terminal and confirm with:

    java -version

    Skip this step if you already have a suitable Java version installed.

  2. 2

    Download the Developer Edition

    Grab the archive for your operating system from the Downloads page.

  3. 3

    Extract the archive

    Extract the downloaded file into a suitable working folder. You should see flowcentral-convergence.jar and an application.properties file at the root.

  4. 4

    Navigate into the extracted folder

    Open a command prompt or terminal and cd into the folder where you extracted the archive.

    cd path/to/flowcentral-convergence-developer-2026.0.1
  5. 5

    (Optional) Configure database and port

    Open application.properties in any text editor. If you leave it untouched, Convergence starts with an in-memory HSQLDB on port 8080 — perfect for evaluation. See the Configuration section for details.

  6. 6

    Start Convergence

    Launch the platform from the command line:

    java -jar flowcentral-convergence.jar

    Wait for the server to finish starting - you'll see a log line confirming the port is bound. Then open your browser and navigate to:

    http://localhost:8080

    Log in with the default credentials:

    UsernameSYSTEM
    Passwordsystem
CONFIGURATION

Optional: tune application.properties.

Out of the box, Convergence runs with an in-memory HSQLDB on port 8080 - no setup required. When you're ready to point at a real database or change the port, edit the properties file below.

application.properties Edit and restart instance
# Server
(uncomment to use)
#jetty-embeddedwebserver.httpPort=8080

# PostgreSQL example (uncomment to use)
#application-datasource.dialect=postgresql-dialect
#application-datasource.connectionUrl=jdbc:postgresql://localhost:5432/convergencedb
#application-datasource.appSchema=public
#application-datasource.username=app
#application-datasource.password=s3cr3t
TROUBLESHOOTING

Frequently asked questions.

Stuck on a step? Most issues come down to Java version, port conflicts, or file permissions. Check the answers below first.

Which Java version do I need?

Java 1.8 (Java 8) or later. Any vendor is supported - Oracle JDK, Adoptium (Temurin), Amazon Corretto, Azul Zulu, Microsoft OpenJDK. Run java -version to verify.

Do I have to install a database?

No. Out of the box, FlowCentral Convergence uses an in-memory HSQLDB — nothing to install, nothing to configure. When you're ready, you can point it at PostgreSQL, SQL Server, Oracle, MySQL or MariaDB by editing application.properties.
NOTE: The in-memory database is non-persistent; all records are lost when the instance is stopped..

Port 8080 is already in use. What do I do?

Open application.properties the uncomment and change jetty-embeddedwebserver.httpPort to any free port (for example 8081). Restart the JAR.

Can I run this on Linux without a GUI?

Yes. FlowCentral Convergence is a headless server - no GUI required on the host. You access the instance from any browser on any machine that can reach the server.

How do I stop the server?

Press Ctrl + C in the terminal where the JAR is running. The server shuts down cleanly.

What are the default login credentials?

Username: SYSTEM - Password: system. Change these immediately if you're exposing the server beyond localhost.

TECHNICAL DEEP-DIVE

Need help wiring Convergence to your data estate?

Schedule a technical deep-dive with our engineering team. We'll walk through JDBC connectivity, security configuration, and deployment topology for your environment.

GET IN TOUCH

Stuck? We're here.

Our team typically responds within one business day. Reach out for help with installation, configuration, or to request the Enterprise Edition for production deployment.

Prefer a call?

Tell us a little about your environment and we'll set up a 30-minute walkthrough with the right specialist — no obligation, no pressure.