--- layout: default ---
The Apache Software Foundation

## About

James stands for Java Apache Mail Enterprise Server!
It has a modular architecture based on a rich set of modern and efficient components which provides at the end complete, stable, secure and extendable Mail Servers running on the JVM.

Create your own personal solution of emails treatment by assembling the components you need thanks to the Inversion of Control mail platform offered and go further customizing filtering and routing rules using James Mailet Container.

### James from a technical point of view

Complete portability (100% pure JVM: Java & Scala)
Built with Java 11 and running on the Java RE 11.
James Components:
- Emailing protocols: SMTP, LMTP, POP3, IMAP, ManageSieve, JMAP
- Mailet container: independent, extensible and pluggable email processing agents
- Storage API: Mailbox API / Search API / User API
- Storage Implementations: Cassandra / PostgreSQL / HSQLDB / MySQL / ElasticSearch...
- Administration: JMX / REST / Command Line
- James Core

Your James server can also be used as Mail Transfer Agent, by enabling only SMTP or as a IMAP Mail Delivery Agent.

james general architecture using james as smtp relay using james as an imap server
Click here to see how-tos for some James features

## James is a living Open Source project (all developments and implementations are based on open technical standards), any function which is not already available from can be developed!

## Get Started With James

- → WHAT WILL YOU TRY:
  Here you will try James server v 3.6.0 thanks to an image. This James image has a default configuration using JPA (hsqldb) and Lucene. It also includes a default domain named james.local and three default users: user01, user02, user03, with their default password being 1234.
  Note: this James server will respond to IMAP port 143 and SMTP port 25.
- →STEPS YOU HAVE TO FOLLOW:
  Pull and run the James image with the following single command:
  `docker run -p "25:25" -p "143:143" linagora/james-jpa-sample:3.6.0`
  Then, connect this image with for instance, Thunderbird.
  Notes: for more information about James CLI, have a look at 'Useful commands section README.txt'.
- →ALTERNATIVES:
  Instructions that do not imply docker are also available here.
- →BETA: Distributed James server
  Recent work of the Apache James project did lead to a James product that leverages a distributed mail server, using storage technologies like Cassandra, ElasticSearch, RabbitMQ, and objectStorage (S3/Swift).
  Feedback on this product, announced as a beta since 3.6.0 is welcome.
  This product can be executed via docker-compose or you can follow its standard installation guide

## Roadmap

- MAIN GOALS
  - →Providing a distributed mail server, fully horizontally scalable.
  - →Maintaining a standalone version suitable for a single server, based on JPA.
- INCOMING FEATURES
  - →Rework our documentation with Antora, specify it on a per-server basis for ease of use.
    We will furthermore target servers to identified use cases, formulated in non technical terms: Basic Server, Advanced Server and Distributed Server.
    Spring server will be deprecated. A summary of community call describing this item can be found here.
  - →Improve developper experience with a migration to the Gradle build system and Apache hosted automated builds. A summary of community call describing this item can be found here.
  - →Update the currently implemented JMAP draft specification to the new JMAP RFC. See this ADR for more information.
  - →Blobs garbage collector: the deduplication mechanism used to save some spaces makes it complicated to remove blobs. We are implementing a garbage collector responsible for removing the no more used blobs. See this ADR (Architecture Decision Record) for more explanation.
  - →Enhance our eventual consistency model by providing tools for reparing projections. See this discussion for more information.
  - →Feel free to add your own items here: see Contribute.

## Last Posts

{% for post in site.posts limit:2 %}
- {{ post.title }} - {{ post.date | date: '%B %d, %Y' }}
  {{ post.excerpt }}
{% endfor %}

## Community

Apache James Project is an Open Source all-volunteer project obtaining its strength from its Community made of developers and users. All are welcome to the Community!
That way, we recommend that Users, Developers, Curious and Fans join the James Community.

- Mailing list:
  Subscribe to the appropriate Mailing Lists according to your interests and your profile.
  Mail guidelines explain you more precisely how it works.
- Gitter chat room:
  Chat in live with the community on Gitter chat room.
- Twitter:
  Express yourself and follow us @ApacheJames.
- Download Apache James releases:
  Our download page allows you to download artifacts and sources for the James Server and James libraries.
- Professional support:
  Find a list of companies which can provide you some support on James.

## Contribute

James is a project that lives from the contributions of its community.
Anyone can contribute! That's right, we always want to hear from people with contributions to the code, the documentation, the website, and bug reports. We more than welcome non-coding contributions.
Here are different ways to contribute:

- Licenses:
  All contributions to the James project are made under the Apache license 2.0
- Join the community:
  We more than welcome articles and blog posts about James.
  Contact us by email or on Gitter to share your experiences.
  Don't hesitate to promote the Apache James project on your preferred medias.
- Report bugs:
  You can here enter bug encountered, share your point of view about a specific feature or anything else...
  Each subproject has its own bug tracker. Go to James Server project bugtracker.
  For other projects click on the appropriate links mentioned in the concerned subproject. Finally, create your issue.
- Documentation:
  Documentation is an easy way to get on board!
  Check out the ~documentation label on JIRA to get some ideas.
  Report on JIRA the typo you spots, the information you miss, and any improvement you can think to.
  The next step is to contribute the documentation changes via Git.
- How to contribute code changes:
  Read our sources from the Apache Git.
  You can also come and interact with us on GitHub and share your work by creating a pull request.
  Alternatively, you can attach a patch to the JIRA issue.
  After a review, and exchanges with you, an Apache James developer will integrate the changes once it matches our policies.
- What contributions can you do:
  We reference some easy tasks to start with : ~newbie
  We have a collection of minor fixes awaiting contributions: ~easyfix
  Challenge yourself with some cool features we thought to: ~feature
  Additional ideas are more than welcome. Don't hesitate to discuss that with us!
- Reporting security vulnerabilities:
  Security: Vulnerabilities should be announced to the Apache Security team.
  PMCs will be notified about them, and will work hard to propose fixes as fast as possible.
- Additional information:
  The contribute page contains more details about the various details exposed above.
  To match the quality expectations of our community, we enforce coding standards. We rely on checkstyle for style checking.

## James use-cases

Linagora
OpenPaaS

##

At LINAGORA, we chose JAMES as the Mail Delivery Agent of our OpenPaaS product:

- For easy administration of email load balancing and high availability
- To allow email interactions with the platform
- To use the JMAP protocol (the browser interacts directly with the mail server)

Our deployment currently allows serving a hundred users over JMAP, SMTP and IMAP.

## Some statistics...

- Contributors
- Last year commits
- Forks
- Stars

## ...and contributors