mvn compile jib:dockerBuildThis produces a linagora/webadmin-proxy:latest image with the sample configuration.json bundled at /root/conf/configuration.json.
docker run \
-p 8001:8001 \
-e OIDC_INTROSPECT_CREDENTIALS="<oidc-client-secret>" \
-e TWAKEMAIL_WEBADMIN_TOKEN="<james-admin-token>" \
linagora/webadmin-proxyThe bundled configuration points to http://127.0.0.1:8180 for OIDC and http://127.0.0.1:8000 for the James backend — suitable only for host-network scenarios or local testing. For real deployments, mount a custom configuration file.
docker run \
-p 8001:8001 \
-v /path/to/your/configuration.json:/root/conf/configuration.json:ro \
-e OIDC_INTROSPECT_CREDENTIALS="<secret>" \
-e TWAKEMAIL_WEBADMIN_TOKEN="<token>" \
linagora/webadmin-proxyTo expose metrics and health-check endpoints, enable self.webadmin.enabled and map the admin port:
{
"self.webadmin.enabled": "true",
"self.webadmin.port": "8002"
}docker run \
-p 8001:8001 \
-p 8002:8002 \
-v /path/to/configuration.json:/root/conf/configuration.json:ro \
-e OIDC_INTROSPECT_CREDENTIALS="<secret>" \
-e TWAKEMAIL_WEBADMIN_TOKEN="<token>" \
linagora/webadmin-proxyThen:
curl http://localhost:8002/healthcheck
curl http://localhost:8002/metricsservices:
webadmin-proxy:
image: linagora/webadmin-proxy:latest
ports:
- "8001:8001"
- "8002:8002"
volumes:
- ./configuration.json:/root/conf/configuration.json:ro
environment:
OIDC_INTROSPECT_CREDENTIALS: "${OIDC_INTROSPECT_CREDENTIALS}"
TWAKEMAIL_WEBADMIN_TOKEN: "${TWAKEMAIL_WEBADMIN_TOKEN}"
restart: unless-stoppedSensitive values should always be passed as environment variables and referenced in configuration.json using {ENV:VAR_NAME}. Never embed credentials directly in the configuration file.
| Variable | Used for |
|---|---|
OIDC_INTROSPECT_CREDENTIALS |
Value of oidc.introspect.credentials |
TWAKEMAIL_WEBADMIN_TOKEN |
Value of webadmin.token for each client |
Additional environment variables can be introduced freely by adding {ENV:MY_VAR} references to your configuration file.