Reading Time: 5 minutes


In this tutorial, our objective is to install WildFly on an unmanaged CentOS 7 server. WildFly is a managed application runtime server and Java software platform used to provision Java applications and services. It is an open-source software which is consistently being improved by its user community. While the WildFly software remains open-source, if paid support is needed, it is provided by Red Hat who currently develops the software (apart from the community forums). Some may be more familiar with WildFly's previous name, which was JBoss AS. RedHat continues to develop its version of this software under the JBoss EAP name.


Here is a summary of the prerequisites and environment that we will be using in this tutorial.

Update CentOS

Our first step before doing any work on the server is to ensure we have the latest updates and software installed. To accomplish this, we will run the following commands.

root@host:~# yum check-update
root@host:~# yum clean all
root@host:~# yum update

OpenJDK Installation

OpenJDK (or the Open Java Development Kit) is a free and open-source implementation of the Java Platform, Standard Edition. It is one of the most popular open-source Java platforms used today. We will be installing OpenJDK prior to installing WildFly.

Initially, we need to log in to the server via SSH as the root user. The first command we will run will install the OpenJDK software. This installation will produce quite a bit of output, which we have concatenated for brevity.

root@host [~]# yum install java-1.8.0-openjdk-devel -y
Installing : libxslt-1.1.28-5.el7.x86_64 1/17
Installing : python-lxml-3.2.1-4.el7.x86_64 2/17
Installing : python-javapackages-3.4.1-11.el7.noarch 3/17
Installing : javapackages-tools-3.4.1-11.el7.noarch 4/17
Installing : ttmkfdir-3.0.9-42.el7.x86_64 5/17
Installing : lksctp-tools-1.0.17-2.el7.x86_64 6/17
Installing : tzdata-java-2019c-1.el7.noarch 7/17
Installing : pcsc-lite-libs-1.8.8-8.el7.x86_64 8/17
Installing : libXtst-1.2.3-1.el7.x86_64 9/17
Installing : libfontenc-1.1.3-3.el7.x86_64 10/17
Installing : 1:xorg-x11-font-utils-7.5-21.el7.x86_64 11/17
Installing : xorg-x11-fonts-Type1-7.5-9.el7.noarch 12/17
Installing : copy-jdk-configs-3.3-10.el7_5.noarch 13/17
Installing : 1:java-1.8.0-openjdk-headless- 14/17
Installing : giflib-4.1.6-9.el7.x86_64 15/17
Installing : 1:java-1.8.0-openjdk- 16/17
Installing : 1:java-1.8.0-openjdk-devel- 17/17
Verifying : 1:xorg-x11-font-utils-7.5-21.el7.x86_64 1/17
Verifying : 1:java-1.8.0-openjdk- 2/17
Verifying : giflib-4.1.6-9.el7.x86_64 3/17
Verifying : xorg-x11-fonts-Type1-7.5-9.el7.noarch 4/17
Verifying : libxslt-1.1.28-5.el7.x86_64 5/17
Verifying : copy-jdk-configs-3.3-10.el7_5.noarch 6/17
Verifying : python-javapackages-3.4.1-11.el7.noarch 7/17
Verifying : 1:java-1.8.0-openjdk-headless- 8/17
Verifying : libfontenc-1.1.3-3.el7.x86_64 9/17
Verifying : 1:java-1.8.0-openjdk-devel- 10/17
Verifying : python-lxml-3.2.1-4.el7.x86_64 11/17
Verifying : libXtst-1.2.3-1.el7.x86_64 12/17
Verifying : pcsc-lite-libs-1.8.8-8.el7.x86_64 13/17
Verifying : javapackages-tools-3.4.1-11.el7.noarch 14/17
Verifying : tzdata-java-2019c-1.el7.noarch 15/17
Verifying : lksctp-tools-1.0.17-2.el7.x86_64 16/17
Verifying : ttmkfdir-3.0.9-42.el7.x86_64 17/17
java-1.8.0-openjdk-devel.x86_64 1:
Dependency Installed:
copy-jdk-configs.noarch 0:3.3-10.el7_5 giflib.x86_64 0:4.1.6-9.el7
java-1.8.0-openjdk.x86_64 1: java-1.8.0-openjdk-headless.x86_64 1:
javapackages-tools.noarch 0:3.4.1-11.el7 libXtst.x86_64 0:1.2.3-1.el7
libfontenc.x86_64 0:1.1.3-3.el7 libxslt.x86_64 0:1.1.28-5.el7
lksctp-tools.x86_64 0:1.0.17-2.el7 pcsc-lite-libs.x86_64 0:1.8.8-8.el7
python-javapackages.noarch 0:3.4.1-11.el7 python-lxml.x86_64 0:3.2.1-4.el7
ttmkfdir.x86_64 0:3.0.9-42.el7 tzdata-java.noarch 0:2019c-1.el7
xorg-x11-font-utils.x86_64 1:7.5-21.el7 xorg-x11-fonts-Type1.noarch 0:7.5-9.el7

Now that we have JDK installed, let’s move on to the installation of WildFly

WildFly Installation

As a side note, we should never run WildFly as the root user due to the security risks it poses. Because of this, we will create a new system user and group. To start this next step, we will run the groupadd command to create the “wildfly” user group.

root@host [~]# groupadd -r wildfly

Now, we can add the wildfly user with the useradd command.

root@host [~]# useradd -r -g wildfly -d /opt/wildfly -s /sbin/nologin wildfly

Now that we have created the user and group, we can proceed to installation itself. We will change directories to move to our /tmp directory and then download the latest stable version of WildFly.

root@host [~]# cd /tmp && wget

When download completes, we need to unpack the archive that we downloaded. We will use the following command to accomplish this.

root@host [~]# tar -xf wildfly-18.0.0.Final.tar.gz -C /opt

This command unpacks our archive, and moved it to the /opt directory. Now we need to create a symbolic link to WildFly that will point to the WildFly installation directory. We will use the following command for this task.

root@host [~]# ln -s /opt/wildfly-18.0.0. /opt/wildfly

Now, WildFly will run under the WildFly user and thus, have access to the installation directory.

In the last step of the installation, we will change the ownership of the installation directory to WildFly user with the following command

root@host [~]# chown -RH wildfly: /opt/wildfly-18.0.0.Final/

That completes the installation process. We will now move on to configuring the Wildfly service.


First, we need to create the directory for the WildFly configuration file.

root@host [~]# mkdir -p /etc/wildfly

Copy the configuration file to new directory:

cp /opt/wildfly-18.0.0.Final/docs/contrib/scripts/systemd/wildfly.conf /etc/wildfly/

This is how default configuration file will look.

# The configuration you want to run<br>WILDFLY_CONFIG=standalone.xml
# The mode you want to run<br>WILDFLY_MODE=standalone
# The address to bind to<br>WILDFLY_BIND=

This means that WildFly will run in standalone mode. This can be adjusted according to the needs of the user. In this tutorial we will use it as it is and that means it will listen on all interfaces.

Next step is to copy the WildFly script to the binary directory.

cp /opt/wildfly-18.0.0.Final/docs/contrib/scripts/systemd/ /opt/wildfly-18.0.0.Final/bin/

Once the script is inside binary directory, we need to set it to be executable. We will use the chmod command for this task.

sh -c 'chmod +x /opt/wildfly-18.0.0.Final/bin/*.sh'

Next, we need to copy the systemd unit service file now to /etc/systemd/system/.

cp /opt/wildfly-18.0.0.Final/docs/contrib/scripts/systemd/wildfly.service /etc/systemd/system/

In the next several commands, we will tell systemd that a new service unit file is in place. After this, we will start the WildFly service, and then we will ensure the service is up and running.

systemctl daemon-reload
systemctl start wildfly
systemctl enable wildfly
Created symlink from /etc/systemd/system/ to /etc/systemd/system/wildfly.service.

The output of the Wildfly status command will look like this.

systemctl status wildfly
● wildfly.service - The WildFly Application Server
Loaded: loaded (/etc/systemd/system/wildfly.service; enabled; vendor preset: disabled)
Active: active (running) since Sat 2020-03-14 12:10:27 EDT; 6s ago
Main PID: 2562 (
CGroup: /system.slice/wildfly.service
├─2562 /bin/bash /opt/wildfly-18.0.0.Final/bin/ standalone standalone.xml
├─2564 /bin/sh /opt/wildfly-18.0.0.Final/bin/ -c standalone.xml -b
└─2621 java -D[Standalone] -server -Xms64m -Xmx512m -XX:MetaspaceSize=96M -XX:MaxMetaspaceSize=256m -Djbo...
Mar 14 12:10:27 systemd[1]: Started The WildFly Application Server.

With this completed, we have confirmed that WildFly is up and running.


Now, to run WildFly, we need to make sure port 8080 is open in our firewall. This can be accomplished using the following command.

firewall-cmd --zone=public --permanent --add-port=8080/tcp

Next, we need to reload the firewall.

firewall-cmd --reload

User Setup

To login to Wildfly, we need to complete one last step which is creation of the Wildfly dashboard user. We will use the built-in script for this task. The script is located within the binary directory of WildFly.


When we run this script, it will ask us the following question:

  1. What type of user do you wish to add?
    • a - Management User (
    • b - Application User (

Here, we will select the “a” option and then, the script will ask us for some basic user info. Finally, we will select our username, password and then press enter to use the defaults on the rest of the questions unless we need modify a specific setting.

That's it regarding the software installation! We can now type in the IP address of our site/server with port 8080. For example, 111.222.333.444:8080, and we will see the Wildfly welcome screen.
Wildfly Dashboard

We are now ready to use WildFly on our server. Enjoy!

Get Started Today!

Are you a Java developer seeking to launch a new platform in which you can run your web apps? If so, reach out to us today to find out how we can fulfill all of your server needs. Give us a call at 800.580.4985, or open a chat or ticket with us to speak with one of our knowledgeable Solutions Team or an experienced Hosting Advisors today!

Avatar for Dean Conally

About the Author: Dean Conally

I am a Linux enthusiast and console gamer, dog lover, and amateur photographer. I've been working at Liquid Web for a bit less than two years. Always looking for knowledge to expand my expertise, thus tackling new technologies and solutions one day at a time.

Latest Articles

Using a Cloudflare Argo Tunnel with load balancing

Read Article

Subdomain takeover — protect your website against it!

Read Article

Controlling PHP settings with a custom php.ini file

Read Article

Linux dos2unix command syntax — removing hidden Windows characters from files

Read Article

Change cPanel password from WebHost Manager (WHM)

Read Article