This guide provides a full Ansible playbook to deploy WildFly using Docker Compose.
It covers Debian 10 to latest stable, Ubuntu LTS releases, and RHEL 9+ compatible systems.
- name: Install WildFly with Docker
hosts: wildfly
become: true
vars:
wildfly_project_dir: /opt/wildfly
wildfly_image: "quay.io/wildfly/wildfly:39.0.1.Final"
wildfly_container_name: wildfly
wildfly_host_http_port: 8080
wildfly_container_http_port: 8080
wildfly_host_mgmt_port: 9990
wildfly_container_mgmt_port: 9990
wildfly_config_dir: "{{ wildfly_project_dir }}/config"
wildfly_deployments_dir: "{{ wildfly_project_dir }}/deployments"
tasks:
- name: Install Docker prerequisites on Debian/Ubuntu
apt:
name:
- apt-transport-https
- ca-certificates
- curl
- gnupg
- lsb-release
state: present
update_cache: true
when: ansible_os_family == "Debian"
- name: Install Docker prerequisites on RHEL family
dnf:
name:
- dnf-utils
state: present
when: ansible_os_family == "RedHat"
- name: Add Docker GPG key on Debian/Ubuntu
apt_key:
url: https://download.docker.com/linux/{{ ansible_distribution | lower }}/gpg
state: present
when: ansible_os_family == "Debian"
- name: Add Docker repository on Debian/Ubuntu
apt_repository:
repo: "deb [arch=amd64] https://download.docker.com/linux/{{ ansible_distribution | lower }} {{ ansible_distribution_release }} stable"
state: present
when: ansible_os_family == "Debian"
- name: Add Docker repository on RHEL family
yum_repository:
name: docker-ce
description: Docker CE Repository
baseurl: "https://download.docker.com/linux/centos/$releasever/$basearch/stable"
gpgcheck: yes
gpgkey: https://download.docker.com/linux/centos/gpg
when: ansible_os_family == "RedHat"
- name: Install Docker packages on Debian/Ubuntu
apt:
name:
- docker-ce
- docker-ce-cli
- containerd.io
- docker-compose-plugin
state: present
update_cache: true
when: ansible_os_family == "Debian"
- name: Install Docker packages on RHEL family
dnf:
name:
- docker-ce
- docker-ce-cli
- containerd.io
- docker-compose-plugin
state: present
when: ansible_os_family == "RedHat"
- name: Enable and start Docker service
systemd:
name: docker
state: started
enabled: true
- name: Create WildFly project directory
file:
path: "{{ wildfly_project_dir }}"
state: directory
mode: "0755"
- name: Create WildFly config directory
file:
path: "{{ wildfly_config_dir }}"
state: directory
mode: "0755"
- name: Create WildFly deployments directory
file:
path: "{{ wildfly_deployments_dir }}"
state: directory
mode: "0755"
- name: Create Docker Compose file
copy:
dest: "{{ wildfly_project_dir }}/compose.yml"
mode: "0644"
content: |
services:
wildfly:
image: {{ wildfly_image }}
container_name: {{ wildfly_container_name }}
ports:
- "{{ wildfly_host_http_port }}:{{ wildfly_container_http_port }}"
- "{{ wildfly_host_mgmt_port }}:{{ wildfly_container_mgmt_port }}"
volumes:
- {{ wildfly_config_dir }}:/opt/jboss/wildfly/standalone/configuration
- {{ wildfly_deployments_dir }}:/opt/jboss/wildfly/standalone/deployments
restart: unless-stopped
environment:
- TZ=UTC
- name: Start WildFly container
community.docker.docker_compose_v2:
project_src: "{{ wildfly_project_dir }}"
state: present
- name: Verify container is running
community.docker.docker_container_info:
name: "{{ wildfly_container_name }}"
register: wildfly_container_info
retries: 5
delay: 3
until: wildfly_container_info.exists == true
latest.After deployment, access WildFly at:
http://SERVER_IP:8080
Admin console:
http://SERVER_IP:9990/console
Copy your WAR/EAR files to the deployments directory:
sudo cp your-app.war /opt/wildfly/deployments/
docker logs wildfly
cd /opt/wildfly
docker compose stop
docker compose start
Any questions?
Feel free to contact us. Find all contact information on our contact page.