WildFly, also known as JBoss, is an open-source and lightweight application server for building Java applications. It is cross-platform and offers a web-based interface that makes managing and configuring WildFly via a web browser easier. It is based on pluggable subsystems and is designed to provide users with a fast and stable Java runtime environment.

This post will show you how to install WildFly on Fedora.

Step 1 – Install Java OpenJDK

WildFly is a Java-based application, so Java JDK must be installed on your server. You can install it with the following command.

dnf install java-11-openjdk.x86_64

Once Java JDK is installed, you can verify the Java installation using the following command.

java --version

You will see the following output.

openjdk 11.0.15 2022-04-19
OpenJDK Runtime Environment 18.9 (build 11.0.15+10)
OpenJDK 64-Bit Server VM 18.9 (build 11.0.15+10, mixed mode, sharing)

Step 2 – Install WildFly and Configure

First, visit the WildFly official website, copy the URL of the latest WildFly version, and download it using the following command.

wget https://github.com/wildfly/wildfly/releases/download/28.0.0.Final/wildfly-28.0.0.Final.zip

Once WildFly is downloaded, unzip the downloaded file with the following command.

unzip wildfly-28.0.0.Final.zip

Next, move the extracted directory to /opt.

mv wildfly-28.0.0.Final /opt/wildfly

Next, create a user and group for WildFly with the following command.

groupadd --system wildfly
useradd -s /sbin/nologin --system -d /opt/wildfly  -g wildfly wildfly

Next, create a WildFly configuration directory and copy all necessary files inside that directory.

mkdir /etc/wildfly
cp /opt/wildfly/docs/contrib/scripts/systemd/wildfly.conf /etc/wildfly/
cp /opt/wildfly/docs/contrib/scripts/systemd/wildfly.service /etc/systemd/system/
cp /opt/wildfly/docs/contrib/scripts/systemd/launch.sh /opt/wildfly/bin/

Next, change the permissions and ownership of the wildfly directory.

chmod +x /opt/wildfly/bin/launch.sh
chown -R wildfly:wildfly /opt/wildfly

Step 3 – Start WildFly Server

At this point, WildFly is installed and configured. Now, reload the systemd daemon using the following command.

systemctl daemon-reload

Next, start and enable the WildFly service with the following command.

systemctl start wildfly
systemctl enable wildfly

You can now check the status of WildFly using the following command.

systemctl status wildfly

You will get the following output.

● wildfly.service - The WildFly Application Server
     Loaded: loaded (/etc/systemd/system/wildfly.service; disabled; vendor preset: disabled)
     Active: active (running) since Sun 2023-05-07 03:40:18 EDT; 6s ago
   Main PID: 35612 (launch.sh)
      Tasks: 63 (limit: 4666)
     Memory: 174.3M
        CPU: 9.503s
     CGroup: /system.slice/wildfly.service
             ├─35612 /bin/bash /opt/wildfly/bin/launch.sh standalone standalone.xml
             ├─35613 /bin/sh /opt/wildfly/bin/standalone.sh -c standalone.xml -b
             └─35709 java -D[Standalone] -Xms64m -Xmx512m -XX:MetaspaceSize=96M -XX:MaxMetaspaceSize=256m -Djava.net.preferIPv4Stack=true -Djboss.modules.system.pkgs=o>

By default, WildFly listens on port 8080. You can check it with the following command.

ss -tunelp | grep 8080


tcp   LISTEN 0      4096*    users:(("java",pid=35709,fd=496)) uid:993 ino:56961 sk:1003 cgroup:/system.slice/wildfly.service <->                          

Now, open your web browser and access the WildFly test page using the URL http://your-server-ip:8080. You will see the WildFly test page on the following screen.

Wildfly test page

Step 4 – Create an Administrator User

Next, you must add an admin user to access the WildFly admin interface. You can create it with the following command.


You should see the following output.

What type of user do you wish to add? 
 a) Management User (mgmt-users.properties) 
 b) Application User (application-users.properties)

Just press the Enter key to create a management user. You will be asked to define your username and password:

Enter the details of the new user to add.
Using realm 'ManagementRealm' as discovered from the existing property files.
Username : adminuser
Password recommendations are listed below. To modify these restrictions edit the add-user.properties configuration file.
 - The password should be different from the username
 - The password should not be one of the following restricted values {root, admin, administrator}
 - The password should contain at least 8 characters, 1 alphabetic character(s), 1 digit(s), 1 non-alphanumeric symbol(s)
Password : 
Re-enter Password : 
What groups do you want this user to belong to? (Please enter a comma separated list, or leave blank for none)[  ]: 
About to add user 'adminuser' for realm 'ManagementRealm'
Is this correct yes/no? yes
Added user 'adminuser' to file '/opt/wildfly/standalone/configuration/mgmt-users.properties'
Added user 'adminuser' to file '/opt/wildfly/domain/configuration/mgmt-users.properties'
Added user 'adminuser' with groups  to file '/opt/wildfly/standalone/configuration/mgmt-groups.properties'
Added user 'adminuser' with groups  to file '/opt/wildfly/domain/configuration/mgmt-groups.properties'

Step 5 – Allow WildFly Remote Access

By default, the WildFly admin interface can be accessed only from the local host, so you must edit the WildFly startup script file and enable the remote access.

nano /opt/wildfly/bin/launch.sh

Change the following lines:

if [[ "$1" == "domain" ]]; then
    $WILDFLY_HOME/bin/domain.sh -c $2 -b $3
    $WILDFLY_HOME/bin/standalone.sh -c $2 -b $3 -bmanagement=

Save and close the file, then restart the WildFly service to apply the changes.

systemctl restart wildfly

Step 6 – Access WildFly Admin Interface

Now, open your web browser and access the WildFly admin interface using the URL http://your-server-ip:9990. You should see the WildFly login page.

wildfly login page

Provide your admin username, password and click on the Login button. You should see the WildFly dashboard on the following screen.

wildfly dashboard


In this post, we explained how to install WildFly on Fedora. You can now build and deploy a Java application in the production environment. Try to install WildFly on dedicated server hosting from Atlantic.Net!