This is an automated email from the ASF dual-hosted git repository.

quantranhong1999 pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/james-project.git

commit 548b5ac543a42a73dcd0eb32c0f67e93d9c2c9bc
Author: Quan Tran <[email protected]>
AuthorDate: Wed Jul 29 10:31:51 2026 +0700

    [DOCUMENTATION] Webadmin: ease custom route demo setup
---
 examples/custom-webadmin-route/README.md                       | 10 +++++++++-
 .../src/main/resources/webadmin.properties                     |  4 ++++
 2 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/examples/custom-webadmin-route/README.md 
b/examples/custom-webadmin-route/README.md
index 1c71b0c731..1ed815059f 100644
--- a/examples/custom-webadmin-route/README.md
+++ b/examples/custom-webadmin-route/README.md
@@ -48,12 +48,20 @@ enabled=true
 port=8000
 host=localhost
 
+# Disable WebAdmin authentication for this local customization demo.
+# Password generation defaults to true when no password is explicitly 
configured.
+password.generate=false
+
 # List of fully qualified class names that should be exposed over webadmin
 # in addition to your product default routes. Routes needs to be located
 # within the classpath or in the ./extensions-jars folder.
 extensions.routes=org.apache.james.examples.RouteA
 ```
 
+This example explicitly disables WebAdmin password generation to keep the 
customization demo simple. By default,
+`password.generate` is enabled and James generates a random WebAdmin password 
at startup when no `password` is
+explicitly configured. Do not disable WebAdmin authentication when exposing it 
beyond this local demo.
+
 Then start a James server with your JAR and the configuration:
 
 ```
@@ -69,4 +77,4 @@ You can play with `curl` utility with the resulting server:
 ```
 $ curl -XGET http://172.17.0.2:8000/hello/a
 RouteA
-```
\ No newline at end of file
+```
diff --git 
a/examples/custom-webadmin-route/src/main/resources/webadmin.properties 
b/examples/custom-webadmin-route/src/main/resources/webadmin.properties
index d19b4e5f2a..db5f66a12d 100644
--- a/examples/custom-webadmin-route/src/main/resources/webadmin.properties
+++ b/examples/custom-webadmin-route/src/main/resources/webadmin.properties
@@ -19,6 +19,10 @@ enabled=true
 port=8000
 host=localhost
 
+# Disable WebAdmin authentication for this local customization demo.
+# Password generation defaults to true when no password is explicitly 
configured.
+password.generate=false
+
 # List of fully qualified class names that should be exposed over webadmin
 # in addition to your product default routes. Routes needs to be located
 # within the classpath or in the ./extensions-jars folder.


---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to