You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@james.apache.org by hq...@apache.org on 2026/07/30 02:00:41 UTC
(james-project) 04/05: [DOCUMENTATION] Webadmin: ease custom route demo setup
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 <hq...@linagora.com>
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: notifications-unsubscribe@james.apache.org
For additional commands, e-mail: notifications-help@james.apache.org