Welcome to the WildFly documentation. The documentation for WildFly is split into multiple categories:

  • Installation Guides for those wanting to understand the flexibility that WildFly offers when it comes to server installation and application deployment.

  • Administrator Guides for those wanting to understand how to install and configure the server.

  • Developer Guides for those wanting to understand how to develop applications for the server.

  • Migration Guide for information related to migrating away from removed features.

  • Model Reference for those wanting information about all of configuration options available via the WildFly management model.

  • Security Guide for those wanting to understand how to secure the WildFly server and applications.

  • Client Guide for those wanting to understand configuration of WildFly clients.

  • Quickstarts for those wanting to jump into code and start using WildFly.

Installation Guides

  • The WildFly and WildFly Preview document introduces the different appserver variants produced by the WildFly project: the standard WildFly variant and the early-look tech preview WildFly Preview variant.

  • The Installation Guide helps you identify the kind of WildFly installation that best fits your application’s deployment needs: a WildFly zip installation, a WildFly server provisioned with Galleon or a WildFly bootable JAR.

  • The Bootable JAR Guide shows you how to package your application and the WildFly server into a bootable JAR.

  • The Galleon Provisioning Guide shows you how to provision a customized WildFly server using Galleon.

Administrator Guides

  • The Getting Started Guide shows you how to install and start the server, how to configure logging, how to deploy an application, how to deploy a datasource, and how to get started using the command line interface and web management interface.

  • The Admin Guide provides detailed information on using the CLI and web management interface, shows you how to administer a WildFly managed domain, and shows you how to configure key subsystems.

  • The High Availability Guide shows you how to create a cluster, how to configure the web container and Jakarta Enterprise Beans container for clustering and how to configure load balancing and failover.

Developer Guides

  • The Getting Started Developing Applications Guide shows you how to build Jakarta EE applications and deploy them to WildFly. The guide starts by showing you the simplest helloworld application using just Servlet and Jakarta Contexts and Dependency Injection, and then adds in Jakarta Server Faces, persistence and transactions, Jakarta Enterprise Beans, Bean Validation, RESTful web services and more. Finally, you’ll get the opportunity to create your own skeleton project. Each tutorial is accompanied by a quickstart, which contains the source code, deployment descriptors and a Maven based build.

  • The Developer Guide ( in progress) takes you through every deployment descriptor and every annotation offered by WildFly.

  • The Extending WildFly guide walks you through creating a new WildFly subsystem extension, in order to add more functionality to WildFly, and shows how to test it before plugging it into WildFly.

  • The WildFly Testsuite guide walks you through testing WildFly.

  • The Hacking on WildFly guide walks you through contributing to WildFly.

Migration Guide

  • The Migration Guide describes alternative options for features which have been removed from WildFly.

Model Reference

  • The WildFly model reference provides information about all standalone server and managed domain configuration options, using information generated directly from the WildFly management model.

Security Guide

Client Guide


  • The WildFly Quickstarts describe how to use the WildFly examples, which introduce a particular technology or feature of the application server.

More Resources