In this tutorial, we will show you how to install WildFly on CentOS 8. For those of you who didn’t know, The WildFly implements the Java Enterprise Edition (Java EE). It is among the most common source Java server applications. It offers you an administration dashboard to manage single or multiple domains efficiently.
This article assumes you have at least basic knowledge of Linux, know how to use the shell, and most importantly, you host your site on your own VPS. The installation is quite simple and assumes you are running in the root account, if not you may need to add ‘sudo
‘ to the commands to get root privileges. I will show you through the step-by-step installation WildFly (JBoss) on a CentOS 8 server.
Prerequisites
- A server running one of the following operating systems: CentOS 8.
- It’s recommended that you use a fresh OS install to prevent any potential issues.
- A
non-root sudo user
or access to theroot user
. We recommend acting as anon-root sudo user
, however, as you can harm your system if you’re not careful when acting as the root.
Install WildFly on CentOS 8
Step 1. First, let’s start by ensuring your system is up-to-date.
sudo dnf update
Step 2. Installing Java OpenJDK.
Install the OpenJDK package by running:
sudo dnf install java-11-openjdk-devel
Step 3. Create a User WildFly.
Running WildFly as the root user is a security risk and not considered best practice. To create a new system user and group named WildFly with a home directory /opt/wildfly
run:
sudo groupadd -r wildfly sudo useradd -r -g wildfly -d /opt/wildfly -s /sbin/nologin wildfly
Step 4. Install WildFly on CentOS 8.
First, Download the latest version of WildFly on the server and extract it using the following commands:
WILDFLY_VERSION=18.0.1.Final wget https://download.jboss.org/wildfly/$WILDFLY_VERSION/wildfly-$WILDFLY_VERSION.tar.gz -P /tmp
Once the download is completed, extract the tar.gz file and move it to the /opt directory:
sudo tar xf /tmp/wildfly-$WILDFLY_VERSION.tar.gz -C /opt/
Next, create a symbolic link WildFly which will point to the WildFly installation directory:
sudo ln -s /opt/wildfly-$WILDFLY_VERSION /opt/wildfly sudo chown -RH wildfly: /opt/wildfly
Step 5. Configure Systemd for WildFly.
First, create a directory that will hold the WildFly configuration file:
sudo mkdir -p /etc/wildfly
Next, copy the configuration file to the /etc/wildfly
directory:
sudo cp /opt/wildfly/docs/contrib/scripts/systemd/wildfly.conf /etc/wildfly/
By default, WildFly will run in a standalone mode and will listen on all interfaces. You can edit the file according to your needs:
nano /etc/wildfly/wildfly.conf
# The configuration you want to run WILDFLY_CONFIG=standalone.xml # The mode you want to run WILDFLY_MODE=standalone # The address to bind to WILDFLY_BIND=0.0.0.0
Next copy the WildFly launch.sh script to the /opt/wildfly/bin/
directory:
sudo cp /opt/wildfly/docs/contrib/scripts/systemd/launch.sh /opt/wildfly/bin/ sudo sh -c 'chmod +x /opt/wildfly/bin/*.sh' sudo cp /opt/wildfly/docs/contrib/scripts/systemd/wildfly.service /etc/systemd/system/
Then, start the WildFly service by executing:
sudo systemctl daemon-reload sudo systemctl start wildfly sudo systemctl enable wildfly
Step 6. Configure the Firewall for WildFly.
Use the following commands to open the necessary port:
sudo firewall-cmd --zone=public --permanent --add-port=8080/tcp sudo firewall-cmd --reload
Step 7. Accessing WildFly Installation.
WildFly will be available on HTTP port 8080 by default. Open your favorite browser and navigate to http://your-domain.com:8080
or http://your-server-ip:8080
and complete the required steps to finish the installation.
Congratulations! You have successfully installed WildFly. Thanks for using this tutorial for installing WildFly JBoss in CentOS 8 system. For additional help or useful information, we recommend you check the official WildFly website.