> ## Documentation Index
> Fetch the complete documentation index at: https://aletyx.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Installing the KIE Server

> The KIE Server is distributed as a web application archive (WAR) file, with packagings for web containers and Java EE containers.

The Aletyx Enterprise Build of KIE Server is distributed as a web application archive (WAR) file.
To install the KIE Execution Server and verify it is running, complete the following steps:

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:

```xml Sample handshaking server response theme={null}
<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](https://www.wildfly.org/) . 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](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.

   <img src="https://mintcdn.com/aletyx-3353d50c/Q-jDgmDFeCeLTJL0/images/kie-server/Installation/maven_war.png?fit=max&auto=format&n=Q-jDgmDFeCeLTJL0&q=85&s=004e5a388a74c452ae37b26e799e265c" alt="Maven WAR" width="1896" height="666" data-path="images/kie-server/Installation/maven_war.png" />

3. Copy the war file into `WILDFLY_HOME/standalone/deployments`.

4. Configure users and roles by executing the following command:

   ```bash theme={null}
   ./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](/docs/kie-server/system-properties) table for the bootstrap switches that can be used to properly configure the instance. For instance:

   ```text theme={null}
   ./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.

   <img src="https://mintcdn.com/aletyx-3353d50c/Tvhapy25_Fkyd3v9/images/kie-server/KieServer/kie-server-info.png?fit=max&auto=format&n=Tvhapy25_Fkyd3v9&q=85&s=9a9c3afbf973bba10ccd41a9a917858e" alt="kie server info" width="640" height="318" data-path="images/kie-server/KieServer/kie-server-info.png" />