[[index]]
= WildFly Documentation
:ext-relative: {outfilesuffix}
ifdef::env-github[:imagesdir: images/]
:toc!:

image:splash_wildflylogo_small.png[WildFly, align="center"]

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.

* _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]]
== Installation Guides

* The link:Installation_Guide{outfilesuffix}[Installation Guide] help 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 link:Bootable_Guide{outfilesuffix}[Bootable JAR Guide] shows you how to package your application and the WildFly server
into a bootable JAR.

* The link:Galleon_Guide{outfilesuffix}[Galleon Provisioning Guide] shows you how to 
provision a customized WildFly server using Galleon.

[[administrator-guides]]
== Administrator Guides

* The link:Getting_Started_Guide{outfilesuffix}[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 link:Admin_Guide{outfilesuffix}[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 link:High_Availability_Guide{outfilesuffix}[High Availability Guide] shows
you how to create a cluster, how to configure the web container and EJB
container for clustering and how to configure load balancing
and failover.

[[developer-guides]]
== Developer Guides

* The link:Getting_Started_Developing_Applications_Guide{outfilesuffix}[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 CDI, and
then adds in JSF, persistence and transactions, EJB, 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 link:Developer_Guide{outfilesuffix}[Developer Guide] ( _in progress_) takes
you through every deployment descriptor and every annotation offered by
WildFly.

* The link:JavaEE_Tutorial{outfilesuffix}[JavaEE Tutorial] ( _in progress_)
builds on what you learnt in the
link:Getting_Started_Developing_Applications_Guide{outfilesuffix}[Getting Started
Developing Applications Guide], and shows you how to build a complex
application using Jakarta EE and portable extensions.

* The link:Extending_WildFly{outfilesuffix}[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 link:Testsuite{outfilesuffix}[WildFly Testsuite] guide walks you through testing WildFly

== Model Reference

* The link:wildscribe[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

* The link:WildFly_Elytron_Security{outfilesuffix}[WildFly Elytron Security] guide walks you through WildFly's new security layer.

== Client Guide

* The link:Client_Guide{outfilesuffix}[WildFly Client Configuration] guide walks you through the new Wildfly client and how to use it.

[[quickstarts]]
== Quickstarts

WildFly comes with a number of quickstarts, examples which introduce to
a particular technology or feature of the application server. The
link:https://github.com/jboss-developer/jboss-developer-shared-resources/blob/master/guides/CONTRIBUTING.md#contribute-a-quickstart[Contributing a Quickstart] section
of the documentation details the available quickstarts.

[[more-resources]]
== More Resources

* link:Glossary.html[Glossary]
* http://www.wildfly.org[WildFly project page]
* https://issues.redhat.com/browse/WFLY[WildFly issue tracker]
* https://community.jboss.org/en/wildfly[WildFly user forum]
* https://community.jboss.org/en/wildfly/dev[WildFly wiki]
* https://github.com/wildfly/wildfly/[WildFly source]
