WildFly Swarm

Maven Central

WildFly Swarm provides a mechanism for building applications as uber jars, with just enough of the WildFly application server wrapped around it to support each application's use-case.

Note: WildFly Swarm requires Maven 3.2.5 or higher for building your application. If you are on Fedora, the Maven 3.2.5 build won't work, as it uses an older version of Aether that was replaced in the official Maven 3.2.5 release. You'll need to manually install Maven.

Note: WildFly Swarm requires JDK 8 or higher for building your application or for building WildFly Swarm itself.

Project Configuration

In a normal WAR-based maven pom.xml, simply add the following


This will take the .war file normally created by your build, and wrap it in the wildfly-swarm mechanisms.

If you normally produce myapp-1.0.war, in your target/ directory will then also be present a myapp-1.0-swarm.jar.

In order to specify the portions of the WildFly AS your application needs, your pom.xml should specify some of the following dependencies within the org.wildfly.swarm Maven group-id:

How To Build WildFly Swarm Itself

WildFly Swarm attempts to be a well-behaved Maven project. To install to your local repository for usage:

mvn install

If you're running short on time:

mvn install -DskipTests

Issue Tracking

Issues are being tracked using the JBoss issue tracking system (JIRA). Bug reports and feature requests are greatly appreciated.


For a more complete set of documentation, go to the WildFly Swarm User's Guide.