Skip to content

Update install guide with working JavaMail download links - #153

Open
mraible wants to merge 1 commit into
apache:masterfrom
mraible:update-install-guide-javamail-link
Open

Update install guide with working JavaMail download links#153
mraible wants to merge 1 commit into
apache:masterfrom
mraible:update-install-guide-javamail-link

Conversation

@mraible

@mraible mraible commented Jul 28, 2026

Copy link
Copy Markdown

Summary

  • Replaced the dead JavaMail download link (https://java.net/projects/javamail/pages/Home) with direct Maven Central links for jakarta.mail-1.6.7.jar and jakarta.activation-1.2.2.jar
  • Added an explanation for why the JavaMail JARs are required even without email features: Roller uses javax.mail.internet.InternetAddress for email address validation in core code (Utilities.java), so the dependency is loaded at runtime regardless of mail configuration
  • Updated the SMTP Javadoc link from javamail.java.net to the current Eclipse project URL

Context

Without the JavaMail JARs in Tomcat's lib/, Roller throws a 500 error on login with ClassNotFoundException: javax.mail.internet.AddressException. The install guide already says to add these JARs, but the download link has been dead since java.net was shut down, making it easy to skip or miss this step.

The JavaMail download link pointed to https://java.net/projects/javamail
which no longer exists. Updated to provide direct Maven Central links
for jakarta.mail and jakarta.activation JARs, and explained why the
dependency is required even without email features (Roller uses the
JavaMail API for email address validation in core code). Also updated
the SMTP package Javadoc link to the current Eclipse project URL.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant