feat: enable Java remote debugging on all Openfire containers

Adds JDWP debug agent configuration to all deployment options, exposing
debug ports on localhost (5005 for xmpp1, 5006 for xmpp2, etc.). The
agent runs in non-blocking mode (suspend=n) so containers start normally
without waiting for a debugger - there's no impact on regular usage.

This reduces friction for developers who frequently need to debug
Openfire, eliminating the need to maintain local uncommitted changes
or remember JDWP syntax.

README.md

@@ -47,3 +47,18 @@ SQL files use numeric prefixes to control execution order:
 - `001-*.sql`, `002-*.sql`, etc. - Additional seed data or configuration
 
 If you need to add custom SQL scripts (e.g., for test data or configuration), use an appropriate numeric prefix to ensure correct execution order.
+
+## Remote Debugging
+
+All Openfire containers are configured with Java remote debugging enabled via JDWP. The debug agent runs in non-blocking mode (`suspend=n`), so containers start normally without waiting for a debugger to attach.
+
+Debug ports are exposed on localhost:
+
+| Server | Port |
+|--------|------|
+| xmpp1 (or xmpp) | 5005 |
+| xmpp2 | 5006 |
+| xmpp3 | 5007 |
+| otherxmpp | 5008 |
+
+To attach your IDE, create a remote debug configuration pointing to `localhost` on the appropriate port.

cluster/docker-compose-clustered.yml

@@ -28,8 +28,12 @@ services:
       - "7071:7070"
       - "7441:7443"
       - "9091:9090"
+      - "5005:5005"
     depends_on:
       - "db"
+    environment:
+      JAVA_TOOL_OPTIONS: >
+        -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005
     volumes:
       - ./_data/xmpp/1/conf:/var/lib/openfire/conf
       - ./_data/plugins:/opt/plugins
@@ -44,8 +48,12 @@ services:
       - "7072:7070"
       - "7442:7443"
       - "9092:9090"
+      - "5006:5005"
     depends_on:
       - "db"
+    environment:
+      JAVA_TOOL_OPTIONS: >
+        -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005
     volumes:
       - ./_data/xmpp/2/conf:/var/lib/openfire/conf
       - ./_data/plugins:/opt/plugins
@@ -60,8 +68,12 @@ services:
       - "7073:7070"
       - "7443:7443"
       - "9093:9090"
+      - "5007:5005"
     depends_on:
       - "db"
+    environment:
+      JAVA_TOOL_OPTIONS: >
+        -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005
     volumes:
       - ./_data/xmpp/3/conf:/var/lib/openfire/conf
       - ./_data/plugins:/opt/plugins

cluster_with_federation/docker-compose-clustered.yml

@@ -28,8 +28,12 @@ services:
       - "7071:7070"
       - "7441:7443"
       - "9091:9090"
+      - "5005:5005"
     depends_on:
       - "db"
+    environment:
+      JAVA_TOOL_OPTIONS: >
+        -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005
     volumes:
       - ./_data/xmpp/1/conf:/var/lib/openfire/conf
       - ./_data/plugins:/opt/plugins
@@ -44,8 +48,12 @@ services:
       - "7072:7070"
       - "7442:7443"
       - "9092:9090"
+      - "5006:5005"
     depends_on:
       - "db"
+    environment:
+      JAVA_TOOL_OPTIONS: >
+        -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005
     volumes:
       - ./_data/xmpp/2/conf:/var/lib/openfire/conf
       - ./_data/plugins:/opt/plugins
@@ -60,8 +68,12 @@ services:
       - "7073:7070"
       - "7443:7443"
       - "9093:9090"
+      - "5007:5005"
     depends_on:
       - "db"
+    environment:
+      JAVA_TOOL_OPTIONS: >
+        -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005
     volumes:
       - ./_data/xmpp/3/conf:/var/lib/openfire/conf
       - ./_data/plugins:/opt/plugins
@@ -87,8 +99,12 @@ services:
       - "7079:7070"
       - "7449:7443"
       - "9099:9090"
+      - "5008:5005"
     depends_on:
       - "otherdb"
+    environment:
+      JAVA_TOOL_OPTIONS: >
+        -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005
     volumes:
       - ./_data/xmpp/otherdomain/conf:/var/lib/openfire/conf
       - ./_data/plugins_for_otherdomain:/opt/plugins

federation/docker-compose-federated.yml

@@ -30,8 +30,12 @@ services:
       - "7071:7070"
       - "7441:7443"
       - "9091:9090"
+      - "5005:5005"
     depends_on:
       - "db1"
+    environment:
+      JAVA_TOOL_OPTIONS: >
+        -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005
     volumes:
       - ./_data/xmpp/1/conf:/var/lib/openfire/conf
       - ./_data/plugins:/opt/plugins
@@ -46,8 +50,12 @@ services:
       - "7072:7070"
       - "7442:7443"
       - "9092:9090"
+      - "5006:5005"
     depends_on:
       - "db2"
+    environment:
+      JAVA_TOOL_OPTIONS: >
+        -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005
     volumes:
       - ./_data/xmpp/2/conf:/var/lib/openfire/conf
       - ./_data/plugins:/opt/plugins

proxy/docker-compose.yml

@@ -31,8 +31,12 @@ services:
       - "7070:7070"
       - "7443:7443"
       - "9090:9090"
+      - "5005:5005"
     depends_on:
       - "db"
+    environment:
+      JAVA_TOOL_OPTIONS: >
+        -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005
     volumes:
       - ./_data/xmpp/conf:/var/lib/openfire/conf
       - ./_data/plugins:/opt/plugins

simple/docker-compose.yml

@@ -19,8 +19,12 @@ services:
       - "7070:7070"
       - "7443:7443"
       - "9090:9090"
+      - "5005:5005"
     depends_on:
       - "db"
+    environment:
+      JAVA_TOOL_OPTIONS: >
+        -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005
     volumes:
       - ./_data/xmpp/conf:/var/lib/openfire/conf
       - ./_data/plugins:/opt/plugins