Installing the KIE Server

1. Deploy the WAR file into your application server, as described below.
2. Create a user with the role of kie-server on the container. Check the section below for the guidelines for your container.
3. Test that you can access KIE Server by navigating to the endpoint in a browser window: http://SERVER:PORT/CONTEXT/services/rest/server/.
4. When prompted for user name/password, type in the user name and password that you created.
5. Once authenticated, you will see an XML response in the form of KIE Server status, similar to this:

<response type="SUCCESS" msg="Kie Server info">
    <kie-server-info>
        <capabilities>KieServer</capabilities>
        <capabilities>BRM</capabilities>
        <capabilities>BPM</capabilities>
        <capabilities>CaseMgmt</capabilities>
        <capabilities>BPM-UI</capabilities>
        <capabilities>Swagger</capabilities>
        <location>http://localhost:8080/kie-server/services/rest/server</location>
        <messages>
            <content>Server KieServerInfo{serverId='first-kie-server',
                version='10.1.2-aletyx-ks-005', name='first-kie-server',
                location='http://localhost:8080/kie-server/services/rest/server',
                capabilities=[KieServer, BRM, BPM, CaseMgmt, BPM-UI, Swagger]', messages=null',
                mode=DEVELOPMENT}started successfully at Thu Aug 06 16:01:49 CEST 2026</content>
            <severity>INFO</severity>
            <timestamp>2026-08-06T16:01:49.722+02:00</timestamp>
        </messages>
        <mode>DEVELOPMENT</mode>
        <name>first-kie-server</name>
        <id>first-kie-server</id>
        <version>10.1.2-aletyx-ks-005</version>
    </kie-server-info>
</response>

​

Application Server Deployment

​

WildFly 35.0.0

1. Download and unzip your WildFly distribution file from the project website . Let’s call the root of the distribution WILDFLY_HOME.
2. Download the kie-server war file (kie-server-10.1.2-aletyx-ks-005-ee10.war). From https://my.aletyx.ai/maven, download your .war file. Find the file under org/kie/server/kie-server/10.1.2-aletyx-ks-005 You can rename the file to simply “kie-server.war” to set “kie-server” as context path, or map your prefered context path in wildfly configuration.
3. Copy the war file into WILDFLY_HOME/standalone/deployments.
4. Configure users and roles by executing the following command:
   ./bin/add-user.sh -a -u kieserver -p ChangeMe123 -g kie-server
   
   The -a flag adds the user to the application realm (ApplicationRealm), and -g assigns its groups. You can choose a different user name and password, just make sure that the user has the role kie-server.
5. Start the server by running WILDFLY_HOME/bin/standalone.[sh|bat] -c standalone-full.xml <bootstrap_switches>. You can check out the standard output or WildFly logs in WILDFLY_HOME/standalone/logs to see if the application deployed successfully. See the KIE Server system properties table for the bootstrap switches that can be used to properly configure the instance. For instance:
   ./standalone.sh   -b 0.0.0.0 \
                     --server-config=standalone-full.xml \
                     --Dorg.kie.server.id=first-kie-server \
                     --Dorg.kie.server.location=http://localhost:8230/kie-server/services/rest/server
   
6. Verify the server is running. Go to http://localhost:8080/kie-server/services/rest/server/ and type the specified user name and password. You should see a simple XML message with basic information about the server.