Skip to content

Latest commit

 

History

History
132 lines (90 loc) · 3.94 KB

README.adoc

File metadata and controls

132 lines (90 loc) · 3.94 KB

License GitHub forks GitHub stars

Apache TomEE

Apache TomEE is a lightweight, yet powerful, JakartaEE Application server with feature rich tooling.

It is the Java Enterprise Edition of Apache Tomcat (Tomcat + JakartaEE = TomEE) and currently is a JakartaEE (formerly JavaEE) and Microprofile compliant application server.

The application server is completely open source and created with community efforts for the public good. Collaborative consensus and peer review according to the Apache Foundation guidelines are used to guarantee the highest quality standards.

Official website: https://tomee.apache.org



Start using TomEE

You can use TomEE to deploy Jakarta EE, Microprofile and Java EE compliant applications.

  • Apache TomEE is distributed 5 different flavors, you can check the comparison table and then proceed to download the distribution for your use case.

  • Documentation and examples are available in the official website.

  • The dozens of application included in the examples/ folder of the project.

Start developing TomEE

TomEE is open source and you can help in its creation.

Apache TomEE is built with Apache Maven >= 3.6.3 and Java 17. The Contribute to TomEE section from the official website for a complete Git, Github, Build, Test, and Continuous Integration details.

Quick build

If you only like to compile all classes and package up TomEE without running tests then you can use the following build options

mvn -Pquick -Dsurefire.useFile=false -DdisableXmlReport=true -DuniqueVersion=false -ff -Dassemble -DskipTests -DfailIfNoTests=false clean install

Full build

This will run all the tests. We have thousands of tests and you should go out to grab a bite in the meantime.

mvn clean install

If you intend building in environments where multicast is not allowed then build with:

mvn clean install -DskipMulticastTests=true

Full build that execute arquillian test on all TomEE distributions:

mvn clean install -Pall-adapters

Partial build

This will only build a module and the modules using it as a dependency.

To build just TomEE distribution execute:

mvn clean install -pl tomee/apache-tomee -am -Dmaven.test.skip=true

TomEE zip/tar.gz will be in tomee/apache-tomee/target

To build TomEE Embedded to be able to develop with its maven plugin execute:

mvn clean install -pl maven/tomee-embedded-maven-plugin -am -Dmaven.test.skip=true

Build with Docker

There is also a docker-compose.yml available to build TomEE with several profiles. For a quick build without tests, you can run

docker compose --profile build-quick up

on the project root. There are additional profiles available, e.g. for attaching with a debugger or running a full build.

Contributing

The community section from the official website offers details on how you can join the mailing lists, file tickets, fix bugs and start to contribute to the project.

Changelog

List of Jira Releases (*)

(*) You need to log in or sign up with a free Apache Jira Account