> For the complete documentation index, see [llms.txt](https://squirrel.k43.ch/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://squirrel.k43.ch/quick-start/download.md).

# Download

<details>

<summary>Planned for next version</summary>

* Experimental Support for HCL Traveler running on the same server as Squirrel (Tested with HCL Domino 14.5.1/HCL Traveler 14.5.1). Please send feedback to <andy.brunner@k43.ch>.
* Remove old Squirrel debug files except the newest 5 files
* Added startup parameter "Help"
* Added command "Tell Squirrel ShowMemory" to display JVM heap space usage
* Minor code and documentation changes
* Changed file in this release: Squirrel.jar

</details>

### Version 2026.03.26

{% file src="/files/NNyY4d1HDpxPu9458x9r" %}

* Major internal rewrite to improve mail rendering of POP3/IMAP messages
* Some minor memory optimizations
* Fix character set conversion bug in 2026.03.14
* Preserve message id in item $MessageID
* Minor code and documentation changes
* Changed files in this release: 1-Squirrel-Jakarta-Mail.jar and Squirrel.jar

### Version 2026.03.14

{% hint style="info" %}
Download of this version has been disabled due to a bug found in the code. Please use version 2026.03.03 or wait for the next version arriving soon.
{% endhint %}

* Changed Java Mail API to new Jakarta Mail/Eclipse Angus
* Changed connect/read/write timeout from 10 to 30 seconds
* Treat "java.net.SocketTimeoutException: Read timed out" as temporary error
* Minor code and documentation changes
* Changed files in this release: 1-Squirrel-Jakarta-Mail.jar and Squirrel.jar

### Version 2026.03.03

{% file src="/files/hpY9a32WKJYe7kLhIBW9" %}

* Support for emails which are represented in Java as javax.mail.util.SharedByteArrayInputStream
* Minor code and documentation changes
* Changed file in this release: Squirrel.jar

### Version 2025.12.09

{% file src="/files/0Rork3z7I9qLXJGKFtCT" %}

* Include JAddin version 2025.11.27
* Change version number scheme from n.n.n to yyyy.mm.dd
* Treat "Login failed: Read timed out" as temporary error
* Minor code and documentation changes
* Changed file in this release: Squirrel.jar

### Version 1.6.13 (2025-09-26)

{% file src="/files/ofivXQillx2s5Vyb6PD2" %}

* Backend: Enforce timeout in connection test to avoid possible connection hangups
* Minor code and documentation changes
* Changed file in this release: Squirrel.jar

### Version 1.6.12 (2025-09-23)

{% file src="/files/SGGZl8X1WhiiyKn670I6" %}

* Backend: Remove BATV header from recipient address (see <https://en.wikipedia.org/wiki/Bounce_Address_Tag_Validation>)
* Backend: Sort mail properties in Jakarta debug log
* Minor code and documentation changes
* Changed file in this release: Squirrel.jar

### Version 1.6.11 (2025-08-11)

{% file src="/files/PwuGxvlyY931RRbav2Ka" %}

* Backend: Create new Jakarta Mail Session for each Connection (instead of using previous Connection)
* Backend: More cleanup code added to avoid rare connection hangups in Jakarta Mail API
* Backend: Force the use of a 10 second timeout for session connect/read
* Minor code and documentation changes
* Changed file in this release: Squirrel.jar

### Version 1.6.10 (2025-06-21)

{% file src="/files/2UZcOgJdPsh0y1rznH8W" %}

* Include updated [JAddin 2.2.1](https://jaddin.k43.ch/) framework
* Backend: Treat connection error "\* BYE Connection closed" as temporary error
* Minor code and documentation changes
* Changed file in this release: Squirrel.jar

### Version 1.6.9 (2025-06-20)

{% file src="/files/sJLPgVKGO9vfQvKPqgKq" %}

* Backend: Support "SingleRun" parameter to terminate Squirrel after processing all subscription documents (see [Start / Stop Squirrel](/quick-start/start-stop-squirrel.md))
* Changed file in this release: Squirrel.jar

### Version 1.6.8 (2025-05-05)

{% file src="/files/7UTOWJIvgfKZM9b0tzhv" %}

* Backend: Add message to connection errors with link to website with debugging information.
* Backend: Add connect timeout (10 secs) to avoid infinite hang-up
* Backend: Added more recovery for temporary mail server errors
* Backend: Improved performance and resilience during shutdown
* Changed file in this release: Squirrel.jar

### Version 1.6.7 (2024-09-03)

{% file src="/files/onrOuxPNhPfOQmb4YRZp" %}

* Include [JAddin 2.1.4](https://jaddin.k43.ch) framework to support HCL Domino 14.5 and higher (JVM with Java 17)

### Version 1.6.6 (2024-05-28)

{% file src="/files/A9WpomfgBMfFf5iBJbFt" %}

* Debug mode: Show HCL Domino JVM classpath during startup
* Treat server error "\[SYS/TEMP] Internal error occurred" as temporary error
* Some minor code changes and optimizations

### Version 1.6.5 (2023-12-22)

{% file src="/files/tMD7l2KYRJMPFo29fwiU" %}

* Prevent logging of user credentials in Jakarta Mail debug log (Squirrel-Debug-yyyy-mm-dd.log)
* Check connection to POP3/IMAP host before processing messages

### Version 1.6.4 (2023-12-16)

{% file src="/files/U08dDwSnLk8hKOd4tE20" %}

* Check if correct Java Mail API classes are installed
* Minor code changes during connection cleanup
* Add special handling for invalid formatted messages causing errors, e.g. "Unable to load BODYSTRUCTURE"
* Include [JAddin](https://jaddin.k43.ch) 2.1.3 framework

### Version 1.6.3 (2023-08-05)

{% file src="/files/06TCMhY60QGst8k58S8C" %}

* Support for emails which are represented in Java as java.io.ByteArraylnputStream
* Prevent log message "duplex close of socket"

### Version 1.6.2 (2023-06-21)

{% file src="/files/lLcN5U6g8sy2JykDaLas" %}

* Use envelope \<Return-Path> or \<X-Envelope-From> if no valid sender found in mail body
* Fix for duplicate cc: and bcc: recipients
* Connection error "BAD User is authenticated but not connected" is now handled as temporary to avoid disabling the subscription document (occurs often in Microsoft 365)
* Enhance server licensing
* Minor text changes in Jakarta Mail debug log
* Include [SOFA 1.0.1](https://sofa.k43.ch/) (minor fixes)
* Documentation: Product website moved to <https://squirrel.k43.ch>

### Version 1.6.1 (2022-10-24)

{% file src="/files/60GMo97793nxkwAVP5tG" %}

* Minor adjustments in debug logging
* Treat errors during OAuth 2.0 authentication as temporary errors to prevent disabling of subscription documents
* Field validation error for OAuth 2.0 fixed
* Encrypt client value/secret field for OAuth 2.0

### Version 1.6.0 (2022-10-19)

{% file src="/files/5MyxN9brRFUjT8zTZzoE" %}

* Add additional fields in account document for OAuth 2.0
* OAuth 2.0 support for IMAP and POP3
* Include the freeware [SOFA](https://sofa.k43.ch) 1.0.0 framework for OAuth 2.0 authentication
* Added file SOFA-Logging.properties to the distribution packet to parameterize the OAuth 2.0 debug logging (see [Debugging Tips](/debugging-tips.md))

### Version 1.5.2 2022-08-15

{% file src="/files/A8Uv8cWnIBpT4RW3RNuG" %}

* Handle X.509 Internet encrypted messages
* Add more detailed debugging information
* Do not automatically convert to UTF-8 charset
* Ignore MIME encoding errors for invalid Internet messages
* Ignore unknown/unsupported MIME encoding specifications

### Version 1.5.1 2021-04-13

{% file src="/files/-MY8jPv6wIEwXptrB7YB" %}
Download
{% endfile %}

{% hint style="warning" %}
If you are upgrading from Squirrel version 1.5.0, you need to delete the two files

* 1-Squirrel-Activation.jar
* 1-Squirrel-Jakarta.jar

from the directory 'Domino/ndext'
{% endhint %}

* Add free version with a limit of three active mail subscriptions
* Support coexistence with HCL Traveler

### Version 1.5.0 2021-03-23

{% file src="/files/-MWUXFUqLQI3BmQ0y7qH" %}
Download
{% endfile %}

* Option in configuration document to send all user account errors to the administrator
* Include [JAddin](https://jaddin.abdata.ch) 2.1.2 framework (minor fixes)
* Include [Eclipse Jakarta Mail](https://eclipse-ee4j.github.io/mail/) and Eclipse Jakarta Activation to replace older JavaMail API
* Write logging from Jakarta Mail API during active debugging to file 'Squirrel-Debug-YYYY-MM-DD.log' (see [Debugging Tips](/debugging-tips.md))
* Squirrel documentation updated and moved to GitBook
* **Experimental support for** [**OAuth 2.0 authentication**](/oauth-2.0-support.md) **(Client XOAUTH2). This feature is currently in a beta phase. Please send any feedback to** [**andy.brunner@abdata.ch**](mailto:andy.brunner@abdata.ch)

### **Version 1.4.2 2021-01-01**

{% file src="/files/-MREStVFci4bKImX5MAX" %}
Download
{% endfile %}

* Show warning message at startup if defined maximum Java heap size is less than 256MB
* Add Domino statistic 'Squirrel.Messages.LastConnectTime' with time of last successful POP3/IMAP server connection
* Remove some original MIME headers to avoid duplicate MIME headers (RFC 5322)
* Added several code enhancements in processing MIME message content
* Minor documentation changes

### **Version 1.4.1 2020-10-18**

{% file src="/files/-MREWi-2Mdo50oqAuxHT" %}
Download
{% endfile %}

* Preserve original recipient fields (To, Cc, Bcc)
* Disable adding Domino domain name (e.g. @ACME) in recipient address
* Handle empty To/From address
* Support RFC 2047 encoded header fields
* Minor documentation changes

### **Version 1.4.0 2020-09-17**

{% file src="/files/-MREWl7qaEqA32oYMV\_m" %}
Download
{% endfile %}

* Support recipient lookup for large Domino directories
* Support manual entry of recipients (e.g. for group names or mail-in databases)
* Minor documentation changes

### **Version 1.3.4 2020-08-02**

{% file src="/files/-MREWl7pmmJ-XdHV6Q9O" %}
Download
{% endfile %}

* Support Domino mail rule "Don't accept message"

### **Version 1.3.3 2020-07-28**

{% file src="/files/-MREWl7o13GVJzo-PvPs" %}
Download
{% endfile %}

* Fix regression error in 1.3.1/1.3.2 "Folder not open"

### **Version 1.3.2 2020-07-13**

{% file src="/files/-MREWl7nKhOeVMzSqfoJ" %}
Download
{% endfile %}

* Retry server login after receiving "EOF on socket"

### **Version 1.3.1 2020-07-11**

{% file src="/files/-MREWl7mRXxBP0-q4i-k" %}
Download
{% endfile %}

* Retry server login after receiving "Temporary authentication failure"

### **Version 1.3.0 2019-12-02**

{% file src="/files/-MREWl7lNFjQ3dxUm4zi" %}
Download
{% endfile %}

* Add option to select all folders to be processed (IMAP servers only)
* Add option to process all messages (read and unread) once for complete mailbox migration (see Administrator Tips)
* Change product references to reflect re-branding (IBM to HCL)
* Code performance enhancements during Domino MIME message body creation
* Show 1 KB message size (instead of 0 KB) on console log for message size < 1 KB
* Add Notes item $SquirrelFolder with the folder name of the original message (see Developer Tips)
* Add check for required ACL roles to be active in configuration database (see Installation)
* Shortened the length of log and debug message to the console

### **Version 1.2.3 2019-08-12**

* Correct bug when receiving Internet messages with text/html and base64 encoding

### **Version 1.2.2 2019-07-01**

* Add 125ms delay between message fetching to avoid race conditions on the Internet mail server
* Set the Notes message item PostedDate to the original time of the message (see Developer Tips)
* Rename the Notes item $SquirrelSentDate to $SquirrelPostedDate and set it to the time of the Squirrel message processing
* Support encoded subject lines, which do not completely follow the RFC 2047 standard.

### **Version 1.2.1 2019-03-18**

* Back-End: Correct display of encoded Internet sender addresses (e.g. "=?utf-8?..")
* Back-End: Minor code cleanup

### **Version 1.2.0 2019-03-09**

* Remove unused action menu
* Mark Sqirrel.ntf as template in database properties&#x20;
* Include JAddin 2.1.1 framework
* Use Domino router database mail1.box if mail.box is not present
* Correct possible loop while encountering startup errors
* Correct NullPointerException for missing sent date in MIME mail
* Support MIME messages which are mapped in Java API as com.sun.mail.util.BASE64DecoderStream
* Add Domino console log message every hour if no mail account document is active
* Force UTF-8 for all MIME character set conversions

### **Version 1.1.0 2019-02-22**

* Configuration document: "Send sys msg to" is now a Domino directory names lookup field
* Internet mail account subscription: New field for comments
* Internet mail account views: Action button for set active/inactive
* Internet mail account views: Include columns for used connections and comments
* Squirrel.ntf template: Set default ACLs
* Minor code changes and cleanups

### **Version 1.0.0 2019-02-10**

* First official release

### **Version 0.8.0 2019-02-05**

* Third internal beta version - Feature completed
* Add all notification email for the administrator

### **Version 0.6.0 2019-01-19**

* Second internal beta version
* Add support for POP3S and POP3

### **Version 0.5.0 2019-01-07**

* First internal beta version

### **Version 0.1.0 2019-01-02**

* First alpha version (Proof of concept)