Skip to content

Latest commit

 

History

History
70 lines (53 loc) · 3.94 KB

README.md

File metadata and controls

70 lines (53 loc) · 3.94 KB
Raw

Tomcat

Docker image for Tomcat version 9.0.34.

Please refer to the Tomcat Documentation for more in-depth information.

As a quick example this will bring up an instance of Tomcat, and allow you to view the manager webapp on http://localhost:80/manager/html/.

docker run --rm -ti \
    -p 8080:8080 \
    islandora/tomcat

Dependencies

Requires islandora/java docker image to build. Please refer to the Java Image README for additional information including additional settings, volumes, ports, etc.

Ports

Port Description
8005 Shut-down
8009 AJP
8080 HTTP
8443 HTTPS

Settings

Environment Variable Confd Key Default Description
TOMCAT_ADMIN_NAME /tomcat/admin/name admin The user name of the manager webapp admin user
TOMCAT_ADMIN_PASSWORD /tomcat/admin/password password The password for the manager webapp admin user
TOMCAT_ADMIN_ROLES /tomcat/admin/roles manager-gui Comma separated list of roles the user has
TOMCAT_CATALINA_OPTS /tomcat/catalina/opts
TOMCAT_JAVA_OPTS /tomcat/java/opts
TOMCAT_LOG_LEVEL /tomcat/log/level INFO Log level. Possible Values: SEVERE, WARNING, INFO, CONFIG, FINE, FINER, FINEST or ALL
TOMCAT_MANAGER_REMOTE_ADDRESS_VALVE /tomcat/manager/remote/address/valve ^.*$ Allows / blocks access to manager app to addresses which match this regex

Additional users/groups/etc can be defined by adding more environment variables, following the above conventions:

Environment Variable Confd Key Description
TOMCAT_USER_{USER}_NAME /tomcat/user/{USER}/name The user name
TOMCAT_USER_{USER}_PASSWORD /tomcat/user/{USER}/password The password for the user
TOMCAT_USER_{USER}_ROLES /tomcat/user/{USER}/roles Comma separated list of roles the user has

N.B. These do not have defaults.

For example to add a new user someone you would need to define the following:

Environment Variable Confd Key Value
TOMCAT_USER_SOMEONE_NAME /tomcat/user/someone/name someone
TOMCAT_USER_SOMEONE_PASSWORD /tomcat/user/someone/password password
TOMCAT_USER_SOMEONE_ROLES /tomcat/user/someone/roles admin

N.B. For all of the settings above, images that descend from this image can apply a prefix to every setting. So for example TOMCAT_CATALINA_OPTS would become FCREPO_TOMCAT_CATALINA_OPTS. This is to allow for different settings on a per-service basis when sharing the same confd backend.