In this tutorial, we will show you how to install WildFly on Debian 10. 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. WildFly Application Server is an exceptionally fast, lightweight, and powerful implementation of the Java Enterprise Edition 8 Platform specifications.
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 on a Debian 9 (Buster).
Prerequisites
- A server running one of the following operating systems: Debian 10 (Buster).
- 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 Debian 10 Buster
Step 1. Before we install any software, it’s important to make sure your system is up to date by running the following apt
commands in the terminal:
sudo apt update sudo apt upgrade
Step 2. Installing Java.
Run the following command to install OpenJDK:
sudo apt install default-jdk
After installing OpenJDK above, you can run the commands below to validate that it is installed:
java -version
Step 3. Create a WildFly User.
We will create a new system user and group named WildFly with a home directory /opt/wildfly
that will run the WildFly service:
sudo groupadd -r wildfly sudo useradd -r -g wildfly -d /opt/wildfly -s /sbin/nologin wildfly
Step 4. Download and Install WildFly Jboss on Debian 10.
First, Download the latest version of WildFly on the server and extract it using the following commands:
WILDFLY_VERSION=21.0.0.Beta1 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 WildFly.
Let’s now create a system user and group that will run the WildFly service:
sudo mkdir -p /etc/wildfly sudo cp /opt/wildfly/docs/contrib/scripts/systemd/wildfly.conf /etc/wildfly/
Then, open the configuration file in the favorite editor through the following command:
sudo 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/
After that, start the WildFly service by executing:
sudo systemctl daemon-reload sudo systemctl start wildfly sudo systemctl enable wildfly
Step 6. Configure the Firewall.
You need to allow traffic on port 8080. If your Debian does not have the UFW firewall application installed by default, run the following command to install it on your system:
sudo apt install ufw sudo ufw allow 8080/tcp
Step 7. Accessing WildFly Web Interface.
WildFly will be available on HTTP port 8080 by default. Open your favorite browser and navigate to http://your-domain.com:8080
or http://server-ip-address:8080
and complete the required steps to finish the installation.
Congratulations! You have successfully installed WildFly. Thanks for using this tutorial for installing the latest version of the WildFly Jboss on Debian 10. For additional help or useful information, we recommend you check the official WildFly website.