# Download

<details>

<summary>Planned for next version</summary>

* Remove old Squirrel debug files except the newest 5 files
* Added command "Tell Squirrel ShowMemory" to display JVM heap space usage
* Minor code and documentation changes

</details>

### Version 2026.03.26

{% file src="<https://288783782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPxpxosKU2KFGoIAhBj%2Fuploads%2FsBzh4vK3HLvQ1oLhfGlQ%2FSquirrel-2026.03.26.zip?alt=media&token=1278fc8a-85bb-4916-b922-bcff425c64a0>" %}

* 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="<https://288783782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPxpxosKU2KFGoIAhBj%2Fuploads%2FvhNodBvnZLUWyVVJggJi%2FSquirrel-2026.03.03.zip?alt=media&token=11a3769f-11ee-4964-a74d-dde356fc2ba4>" %}

* 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="<https://288783782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPxpxosKU2KFGoIAhBj%2Fuploads%2F8NEApTw29UVWmtgqfnyC%2FSquirrel-2025.12.09.zip?alt=media&token=f3ebd4a5-9940-4e25-bc71-da80e46d9e84>" %}

* 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="<https://288783782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPxpxosKU2KFGoIAhBj%2Fuploads%2FIzLx3YlOKDgnhZ5UegTi%2FSquirrel-1.6.13.zip?alt=media&token=9523687b-bfaa-4f1c-9b8d-c3a3032e62ca>" %}

* 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="<https://288783782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPxpxosKU2KFGoIAhBj%2Fuploads%2FPSEwh58FUkQbfuRKTJAX%2FSquirrel-1.6.12.zip?alt=media&token=19e11f35-b35e-44ae-8de4-3fd1ba0cf6ed>" %}

* 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="<https://288783782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPxpxosKU2KFGoIAhBj%2Fuploads%2Ft8rNraA5FpMOTFpgniGr%2FSquirrel-1.6.11.zip?alt=media&token=4e5dac5d-e52d-4929-bd8c-d18f58ce7aa2>" %}

* 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="<https://288783782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPxpxosKU2KFGoIAhBj%2Fuploads%2FgZcYG5dpLITM5m1lomCc%2FSquirrel-1.6.10.zip?alt=media&token=aed94be0-d827-4bc2-9666-465e30e21803>" %}

* 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="<https://288783782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPxpxosKU2KFGoIAhBj%2Fuploads%2Fi9HTieRDfiVgt7wRbZkw%2FSquirrel-1.6.9.zip?alt=media&token=61a7e439-b48c-44b9-98ef-90d529a16e45>" %}

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

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

{% file src="<https://288783782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPxpxosKU2KFGoIAhBj%2Fuploads%2Fi9qk3R1KZWitn77WNPOG%2FSquirrel-1.6.8.zip?alt=media&token=e889b642-f201-4d55-bf9d-f339aa96c076>" %}

* 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="<https://288783782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPxpxosKU2KFGoIAhBj%2Fuploads%2Fyojj0W0XMnoVFG2yaGJE%2FSquirrel-1.6.7.zip?alt=media&token=c79225d1-36fb-419d-9ec8-6a8b22ed64f6>" %}

* 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="<https://288783782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPxpxosKU2KFGoIAhBj%2Fuploads%2FfGQ7nKkIPQnk8ObzyRmC%2FSquirrel-1.6.6.zip?alt=media&token=6f5ba5a4-1bb4-4313-b557-e9146fa5ef93>" %}

* 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="<https://288783782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPxpxosKU2KFGoIAhBj%2Fuploads%2FDtbMAn7I9Xvg3O7YSAVo%2FSquirrel-1.6.5.zip?alt=media&token=880252de-841b-4708-aae2-bfa1d3db3957>" %}

* 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="<https://288783782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPxpxosKU2KFGoIAhBj%2Fuploads%2FTOahhs73cE4YIzzsgZ8A%2FSquirrel-1.6.4.zip?alt=media&token=8f94ad30-4d3d-4bea-843d-729d79feffc5>" %}

* 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="<https://288783782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPxpxosKU2KFGoIAhBj%2Fuploads%2F44trWREMq4YYgx7ROQOh%2FSquirrel-1.6.3.zip?alt=media&token=7ec8b75b-28b7-46b9-b488-bfb2f309ddb2>" %}

* 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="<https://288783782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPxpxosKU2KFGoIAhBj%2Fuploads%2FuiNnw8NRsVOPbedvFJ9h%2FSquirrel-1.6.2.zip?alt=media&token=d0e6d446-7993-4907-8530-725048795b7d>" %}

* 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://app.gitbook.com/o/NMD7znqFhx6eETIvQuKq/s/zpAZYQi6uPI6py1djouu/) (minor fixes)
* Documentation: Product website moved to <https://squirrel.k43.ch>

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

{% file src="<https://288783782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPxpxosKU2KFGoIAhBj%2Fuploads%2F5GW2KIYG5lynxz2Kp92m%2FSquirrel-1.6.1.zip?alt=media&token=399e0228-ff35-4662-9f87-3c56132e026d>" %}

* 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="<https://288783782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPxpxosKU2KFGoIAhBj%2Fuploads%2FtaGbhEkwdXUc1MXeyQ4F%2FSquirrel-1.6.0.zip?alt=media&token=ce93b253-967a-4f3b-9ba2-4f16cf53f19c>" %}

* 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](https://squirrel.k43.ch/debugging-tips))

### Version 1.5.2 2022-08-15

{% file src="<https://288783782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPxpxosKU2KFGoIAhBj%2Fuploads%2FAHmfwVgSIzUtBv2CQn2l%2FSquirrel-1.5.2.zip?alt=media&token=92d045f1-c431-4e62-9e84-1c24b7247d42>" %}

* 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="<https://288783782-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MPxpxosKU2KFGoIAhBj%2F-MY8jMiN5Ke9GwmtEgCj%2F-MY8jPv6wIEwXptrB7YB%2FSquirrel-1.5.1.zip?alt=media&token=1aeb91e9-ca8a-4c05-94b1-36052a2a6484>" %}
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="<https://288783782-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MPxpxosKU2KFGoIAhBj%2F-MWUXCxC5tZbukJijMib%2F-MWUXFUqLQI3BmQ0y7qH%2FSquirrel-1.5.0.zip?alt=media&token=b01aeb6d-3bc0-45bf-b695-33c7fcd8b8be>" %}
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](https://squirrel.k43.ch/debugging-tips))
* Squirrel documentation updated and moved to GitBook
* **Experimental support for** [**OAuth 2.0 authentication**](https://squirrel.k43.ch/oauth-2.0-support) **(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="<https://288783782-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MPxpxosKU2KFGoIAhBj%2F-MRESh2_WlJQRqu_Gmt1%2F-MREStVFci4bKImX5MAX%2FSquirrel-1.4.2.zip?alt=media&token=304332c4-d906-4a75-9d33-f7ea6103bd1e>" %}
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="<https://288783782-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MPxpxosKU2KFGoIAhBj%2F-MREWKiwhAQzpJmYrETT%2F-MREWi-2Mdo50oqAuxHT%2FSquirrel-1.4.1.zip?alt=media&token=3111f33b-288e-4e30-96d1-89a125191fda>" %}
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="<https://288783782-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MPxpxosKU2KFGoIAhBj%2F-MREWKiwhAQzpJmYrETT%2F-MREWl7qaEqA32oYMV_m%2FSquirrel-1.4.0.zip?alt=media&token=451bdad8-6103-40a2-923b-6c61b3f2f94b>" %}
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="<https://288783782-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MPxpxosKU2KFGoIAhBj%2F-MREWKiwhAQzpJmYrETT%2F-MREWl7pmmJ-XdHV6Q9O%2FSquirrel-1.3.4.zip?alt=media&token=d7d6d5fc-ed57-4906-9009-3432fbf3ee8e>" %}
Download
{% endfile %}

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

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

{% file src="<https://288783782-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MPxpxosKU2KFGoIAhBj%2F-MREWKiwhAQzpJmYrETT%2F-MREWl7o13GVJzo-PvPs%2FSquirrel-1.3.3.zip?alt=media&token=8ae768c6-c172-4298-b37c-483e8dfeec46>" %}
Download
{% endfile %}

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

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

{% file src="<https://288783782-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MPxpxosKU2KFGoIAhBj%2F-MREWKiwhAQzpJmYrETT%2F-MREWl7nKhOeVMzSqfoJ%2FSquirrel-1.3.2.zip?alt=media&token=a506c83e-2364-4447-95fa-10743a92afdf>" %}
Download
{% endfile %}

* Retry server login after receiving "EOF on socket"

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

{% file src="<https://288783782-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MPxpxosKU2KFGoIAhBj%2F-MREWKiwhAQzpJmYrETT%2F-MREWl7mRXxBP0-q4i-k%2FSquirrel-1.3.1.zip?alt=media&token=f36c8979-1610-4045-865a-eabc26279a65>" %}
Download
{% endfile %}

* Retry server login after receiving "Temporary authentication failure"

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

{% file src="<https://288783782-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MPxpxosKU2KFGoIAhBj%2F-MREWKiwhAQzpJmYrETT%2F-MREWl7lNFjQ3dxUm4zi%2FSquirrel-1.3.0.zip?alt=media&token=da07413b-ba1d-466f-863b-eb645383f2a2>" %}
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)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://squirrel.k43.ch/quick-start/download.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.