File README.md of Package tomcat-10-image

Overview Repositories Revisions Requests Users Attributes Meta

File README.md of Package tomcat-10-image (Revision 1fdfef89c97131c557f4c7b08105dae6)

Currently displaying revision 1fdfef89c97131c557f4c7b08105dae6 , Show latest

# Tomcat 10 Container Image

Apache Tomcat (Tomcat for short) is a free and open-source implementation of the
Jakarta Servlet, Jakarta Expression Language, and WebSocket technologies. It
provides a pure Java HTTP web server environment that can run Java code. It is a
Java web application server and not a complete JEE application server.

## How to use the image

By default, the image launches Tomcat with the same configuration as the one
that comes with SUSE Linux Enterprise Server. The difference is that logging is
sent to stdout, meaning that the `podman logs tomcat` command displays Tomcat
logs.

For security reasons, the image runs as the **tomcat** user. This means that
additional packages cannot be installed via `zypper`, unless the user becomes
`root`.

To deploy an application, copy the `.war` file file into
`$CATALINA_BASE/webapps` (either during a container build or by bind-mounting
the directory), and launch the container using the following command:
```ShellSession
$ podman run -d --rm -p 8080:8080 registry.suse.com/suse/tomcat:10
```

The deployed webapp is then accessible via `http://localhost:8080/$webapp_name`.

### How to use the image with rootless Podman

The container image can be used in rootless mode with Podman. Keep in mind that
Podman remaps the `tomcat` user in the container to a different user on the
host. This user will not have write access to the mounted directory. To avoid
permission issues change permissions of the shared directory to `0777` as
follows:

```ShellSession
$ chmod 0777 /path/to/my/app
$ podman run --rm -d -v /path/to/my/app:/usr/share/tomcat/webapps:z \
      -p 8080:8080 registry.suse.com/suse/tomcat:10
```

## Configuration

The main Tomcat configuration files (for example
`/etc/tomcat/logging.properties`) are stored in `/etc/tomcat/`.

Tomcat's runtime options can be configured using the environment variables
`JAVA_OPTS` and `CATALINA_OPTS`. `JAVA_OPTS` specifies general options used for
the JVM, whereas `CATALINA_OPTS` specifies Tomcat's flags. You can pass the
options to the container runtime using the `-e` flag:
```ShellSession
$ podman run -it --rm \
      -e JAVA_OPTS="-Xmx1024m" \
      -p 8080:8080 \
      registry.suse.com/suse/tomcat:10
```

The image ships with `CATALINA_HOME` set to `/usr/share/tomcat` and `CATALINA_BASE` set to
`/usr/share/tomcat`.

## Samples

By default, the sample applications shipped with Tomcat are not installed in
the container image. You can obtain them by installing one of the following
packages:
- tomcat10-webapps
- tomcat10-admin-webapps
- tomcat10-docs-webapp

## Upgrading from Tomcat 9

Tomcat 9 implements Java EE 8, and Tomcat 10 implements Jakarta
EE 9. Before upgrading from version 9, consult the upstream migration guide:
https://tomcat.apache.org/migration-10.html

Places

File README.md of Package tomcat-10-image (Revision 1fdfef89c97131c557f4c7b08105dae6)

Places