---
schema_version: "1"
id: 8f2051c4a4a142399c6653ad270343a30c967da04dea617893d851c01f87b401
title: FTP Connector Release Notes for Mule 4
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/release-notes/connector/connector-ftp.md
canonical_url: https://docs.mulesoft.com/release-notes/connector/connector-ftp
source_site: docs.mulesoft.com
content_type: documentation
content_hash: f069f443188c6faeffc9698c44599e8d7de1f677af8ab97b9be127dbf4385fd5
description: MuleSoft Documentation Site
latest: true
---
---
product: Release Notes
version: master
---

# FTP Connector Release Notes for Mule 4

> For the full documentation index, see: https://docs.mulesoft.com/llms.txt

Support Category:
[Select](https://www.salesforce.com/en-us/wp-content/uploads/sites/4/documents/legal/Agreements/versioning-back-support-policy.pdf)

Anypoint Connector for FTP (FTP Connector) provides access to files and folders on an FTP server.

Guide: [FTP Connector User Guide](https://docs.mulesoft.com/ftp-connector/latest/)

## 2.0.4

**May 18, 2026**

### Compatibility

<table><colgroup><col> <col></colgroup><thead><tr><th>Software</th><th>Version</th></tr></thead><tbody><tr><td><p>Mule</p></td><td><p>4.3.0 and later</p></td></tr><tr><td><p>OpenJDK</p></td><td><p>8, 11, and 17</p></td></tr></tbody></table>

### Fixed Issues

<table><colgroup><col> <col></colgroup><thead><tr><th>Issue Resolution</th><th>ID</th></tr></thead><tbody><tr><td><div><div><p>The connector now validates reply codes across all operations and throws a <code>ConnectionException</code> when error code 451 occurs. This ensures that the pool discards stale connections and replaces them with fresh ones.</p></div></div></td><td><div><div><p>W-21477651</p></div></div></td></tr><tr><td><div><div><p>The <strong>On New or Updated File</strong> source now correctly invalidates a corrupted FTP connection if the server response fails to parse or if the control channel abruptly closes during file listing. Previously, the listener returned a malformed connection to the connection pool, causing subsequent polling cycles to fail until you restarted the application.</p></div></div></td><td><div><div><p>W-20316906</p></div></div></td></tr></tbody></table>

## 2.0.3

**December 10, 2025**

### Compatibility

<table><colgroup><col> <col></colgroup><thead><tr><th>Software</th><th>Version</th></tr></thead><tbody><tr><td><p>Mule</p></td><td><p>4.3.0 and later</p></td></tr><tr><td><p>OpenJDK</p></td><td><p>8, 11, and 17</p></td></tr></tbody></table>

### Fixed Issues

<table><colgroup><col> <col></colgroup><thead><tr><th>Issue Resolution</th><th>ID</th></tr></thead><tbody><tr><td><div><div><p>The connector now correctly compares file names when the FTP server returns the full path as part of the file name.</p></div></div></td><td><div><div><p>W-20347004</p></div></div></td></tr><tr><td><div><div><p>The connector now gracefully handles the <code>MalformedServerReplyException: Truncated server reply: '550 '</code> error that some FTP servers return during file existence checks and falls back to listing the parent directory to confirm the file’s existence.</p></div></div></td><td><div><div><p>W-20307018</p></div></div></td></tr><tr><td><div><div><p>The connector now correctly handles the <strong>List</strong> operation when an FTP server supports the MLST command but doesn’t support the MLSD command.</p></div></div></td><td><div><div><p>W-19744198</p></div></div></td></tr></tbody></table>

## 2.0.2

**October 28, 2025**

### Compatibility

<table><colgroup><col> <col></colgroup><thead><tr><th>Software</th><th>Version</th></tr></thead><tbody><tr><td><p>Mule</p></td><td><p>4.3.0 and later</p></td></tr><tr><td><p>OpenJDK</p></td><td><p>8, 11, and 17</p></td></tr></tbody></table>

### Fixed Issues

<table><colgroup><col> <col></colgroup><thead><tr><th>Issue Resolution</th><th>ID</th></tr></thead><tbody><tr><td><div><div><p>These libraries are upgraded to address the reported security vulnerabilities:</p></div><div><ul><li><p>The <code>commons-lang3</code> library is upgraded to version 3.18.0.</p></li><li><p>The <code>Commons-collections</code> library is upgraded to version 4.5.0.</p></li></ul></div></div></td><td><div><div><p>W-19578842</p></div></div></td></tr></tbody></table>

## 2.0.1

**September 28, 2025**

### Compatibility

<table><colgroup><col> <col></colgroup><thead><tr><th>Software</th><th>Version</th></tr></thead><tbody><tr><td><p>Mule</p></td><td><p>4.3.0 and later</p></td></tr><tr><td><p>OpenJDK</p></td><td><p>8, 11, and 17</p></td></tr></tbody></table>

### Fixed Issues

<table><colgroup><col> <col></colgroup><thead><tr><th>Issue Resolution</th><th>ID</th></tr></thead><tbody><tr><td><div><div><p>The connector now correctly processes file attributes when the MLSD command returns output containing blank folder names.</p></div></div></td><td><div><div><p>W-19754116</p></div></div></td></tr></tbody></table>

## 2.0.0

**September 23, 2024**

### Compatibility

<table><colgroup><col> <col></colgroup><thead><tr><th>Software</th><th>Version</th></tr></thead><tbody><tr><td><p>Mule</p></td><td><p>4.3.0 and later</p></td></tr><tr><td><p>OpenJDK</p></td><td><p>8, 11, and 17</p></td></tr></tbody></table>

### Fixed Issues

<table><colgroup><col> <col></colgroup><thead><tr><th>Issue Resolution</th><th>ID</th></tr></thead><tbody><tr><td><div><div><p>The <code>mule-file-commons</code> module dependency is removed to make FTP Connector a standalone connector.</p></div></div></td><td><div><div><p>W-15854291</p></div></div></td></tr><tr><td><div><div><p>The <strong>List</strong> operation now returns the file path instead of the file content.</p></div></div></td><td><div><div><p>W-16004666</p></div></div></td></tr><tr><td><div><div><p>The <strong>List</strong> operation no longer includes the <strong>Time Between Size Check</strong> and <strong>Time Between Size Check Unit</strong> fields because the file content is no longer read.</p></div></div></td><td><div><div><p>W-16280695</p></div></div></td></tr></tbody></table>

## 1.8.8

**March 6, 2024**

### Compatibility

<table><colgroup><col> <col></colgroup><thead><tr><th>Software</th><th>Version</th></tr></thead><tbody><tr><td><p>Mule</p></td><td><p>4.1.2 and later</p></td></tr><tr><td><p>OpenJDK</p></td><td><p>8, 11, and 17</p></td></tr></tbody></table>

### Fixed Issues

<table><colgroup><col> <col></colgroup><thead><tr><th>Issue Resolution</th><th>ID</th></tr></thead><tbody><tr><td><div><div><p>The <strong>Read</strong> operation now finds files that use some special characters while single-file listing.</p></div></div></td><td><div><div><p>W-14650859</p></div></div></td></tr></tbody></table>

## 1.8.7

**January 19, 2024**

### What’s New

- The Commons Net library is upgraded to version 3.8.0.

### Compatibility

<table><colgroup><col> <col></colgroup><thead><tr><th>Software</th><th>Version</th></tr></thead><tbody><tr><td><p>Mule</p></td><td><p>4.1.2 and later</p></td></tr><tr><td><p>OpenJDK</p></td><td><p>8, 11, and 17</p></td></tr></tbody></table>

### Fixed Issues

<table><colgroup><col> <col></colgroup><thead><tr><th>Issue Resolution</th><th>ID</th></tr></thead><tbody><tr><td><div><div><p>The <strong>Read</strong> operation now finds files even if the single-file listing is not supported.</p></div></div></td><td><div><div><p>W-14150759</p></div></div></td></tr></tbody></table>

## 1.8.6

**January 5, 2024**

### What’s New

- This connector is now compatible with Java 17.

### Compatibility

<table><colgroup><col> <col></colgroup><thead><tr><th>Software</th><th>Version</th></tr></thead><tbody><tr><td><p>Mule</p></td><td><p>4.1.2 and later</p></td></tr><tr><td><p>OpenJDK</p></td><td><p>8, 11, and 17</p></td></tr></tbody></table>

## 1.8.5

**July 11, 2023**

### What’s New

- The Commons IO library is upgraded to version 2.13.0.

### Compatibility

<table><colgroup><col> <col></colgroup><thead><tr><th>Software</th><th>Version</th></tr></thead><tbody><tr><td><p>Mule</p></td><td><p>4.1.2 and later</p></td></tr><tr><td><p>OpenJDK</p></td><td><p>8 and 11</p></td></tr></tbody></table>

### Fixed Issues

<table><colgroup><col> <col></colgroup><thead><tr><th>Issue Resolution</th><th>ID</th></tr></thead><tbody><tr><td><div><div><p>The <strong>Read</strong> operation now takes less time to find files when the MLST command is not supported by a server.</p></div></div></td><td><div><div><p>W-13138208, W-13674423</p></div></div></td></tr><tr><td><div><div><p>The Commons IO library is upgraded to version 2.13.0 to address reported security vulnerabilities.</p></div></div></td><td><div><div><p>W-13512345</p></div></div></td></tr></tbody></table>

## 1.8.4 (Deprecated)

**June 13, 2023**

This version is deprecated. All of the features and fixed issues for this version are in version
1.8.5.

## 1.8.3 (Deprecated)

**May 31, 2023**

This version is deprecated. All of the features and fixed issues for this version are in version
1.8.5.

## 1.8.2

**April 27, 2023**

### Fixed Issues

<table><colgroup><col> <col></colgroup><thead><tr><th>Issue</th><th>ID</th></tr></thead><tbody><tr><td><div><div><p>FTP Connector now returns connections to the pool if you configure the pooling profile connection.</p></div></div></td><td><div><div><p>W-12969684</p></div></div></td></tr></tbody></table>

### Compatibility

<table><colgroup><col> <col></colgroup><thead><tr><th>Software</th><th>Version</th></tr></thead><tbody><tr><td><p>Mule</p></td><td><p>4.1.5 and later</p></td></tr><tr><td><p>JDK</p></td><td><p>8</p></td></tr></tbody></table>

## 1.8.1

**September 28, 2022**

### Compatibility

<table><colgroup><col> <col></colgroup><thead><tr><th>Software</th><th>Version</th></tr></thead><tbody><tr><td><p>Mule</p></td><td><p>4.1.5 and later</p></td></tr><tr><td><p>JDK</p></td><td><p>8</p></td></tr></tbody></table>

### Fixed Issues

<table><colgroup><col> <col></colgroup><thead><tr><th>Issue</th><th>ID</th></tr></thead><tbody><tr><td><div><div><p>FTP Connector no longer adds a slash <code>/</code> in front of file name when there is no working directory specified.</p></div></div></td><td><div><div><p>W-11633025</p></div></div></td></tr></tbody></table>

## 1.8.0

**September 14, 2022**

### What’s New

- FTP Connector now supports an independent file system matcher that lists files following FTP RTF
  standards. Use the **Case sensitive** field to configure an external file system matcher as case
  sensitive or insensitive.

### Compatibility

<table><colgroup><col> <col></colgroup><thead><tr><th>Software</th><th>Version</th></tr></thead><tbody><tr><td><p>Mule</p></td><td><p>4.1.2 and later</p></td></tr><tr><td><p>OpenJDK</p></td><td><p>8 and 11</p></td></tr></tbody></table>

## 1.7.1

**September 6, 2022**

### Compatibility

<table><colgroup><col> <col></colgroup><thead><tr><th>Software</th><th>Version</th></tr></thead><tbody><tr><td><p>Mule</p></td><td><p>4.1.5 and later</p></td></tr><tr><td><p>JDK</p></td><td><p>8</p></td></tr></tbody></table>

### Fixed Issues

<table><colgroup><col> <col></colgroup><thead><tr><th>Issue</th><th>ID</th></tr></thead><tbody><tr><td><div><div><p>FTP Connector no longer returns NullPointerException when reading and listing files from the FTP server hosted in an AS400 server.</p></div></div></td><td><div><div><p>W-11697993</p></div></div></td></tr></tbody></table>

## 1.7.0

**Aug 26, 2022**

### Compatibility

<table><colgroup><col> <col></colgroup><thead><tr><th>Software</th><th>Version</th></tr></thead><tbody><tr><td><p>Mule</p></td><td><p>4.1.5 and later</p></td></tr><tr><td><p>JDK</p></td><td><p>8</p></td></tr></tbody></table>

### Fixed Issues

<table><colgroup><col> <col></colgroup><thead><tr><th>Issue</th><th>ID</th></tr></thead><tbody><tr><td><div><div><p>The <strong>On New or Updated File</strong> operation now provides the <strong>Overwrite</strong> field, which enables you to overwrite the target file when the destination file has the same name.</p></div></div></td><td><div><div><p>W-11645841</p></div></div></td></tr></tbody></table>

## 1.6.2

**August 23, 2022**

### Compatibility

<table><colgroup><col> <col></colgroup><thead><tr><th>Software</th><th>Version</th></tr></thead><tbody><tr><td><p>Mule</p></td><td><p>4.1.2 and later</p></td></tr><tr><td><p>OpenJDK</p></td><td><p>8 and 11</p></td></tr></tbody></table>

### Fixed Issues

<table><colgroup><col> <col></colgroup><thead><tr><th>Issue</th><th>ID</th></tr></thead><tbody><tr><td><p>FTP Connector now checks nulls to avoid errors while reading files from AS/400 servers.</p></td><td><p>W-11493458</p></td></tr></tbody></table>

## 1.6.1

**July 4, 2022**

### What’s New

- Upgraded versions of dependencies.

### Compatibility

<table><colgroup><col> <col></colgroup><thead><tr><th>Software</th><th>Version</th></tr></thead><tbody><tr><td><p>Mule</p></td><td><p>4.1.2 and later</p></td></tr><tr><td><p>OpenJDK</p></td><td><p>8 and 11</p></td></tr></tbody></table>

## 1.6.0

**May 30, 2022**

### What’s New

- Added the **Proxy** parameter, which enables you to set the HTTP or HTTPS tunnel proxy in the FTPS
  Connector global configuration.

### Compatibility

<table><colgroup><col> <col></colgroup><thead><tr><th>Software</th><th>Version</th></tr></thead><tbody><tr><td><p>Mule</p></td><td><p>4.1.2 and later</p></td></tr><tr><td><p>OpenJDK</p></td><td><p>8 and 11</p></td></tr></tbody></table>

## 1.5.5

**October 18, 2021**

### What’s New

- When FTP Connector attempted to use the MLSD command to list the directory, the server responded
  with `Command Not Implemented (502)` and before the connector could retry the operation with a
  LIST command, the server closed the connection. A call to the FEAT command is now issued to
  validate that MLST/MLSD commands are supported by the server.

### Compatibility

<table><colgroup><col> <col></colgroup><thead><tr><th>Software</th><th>Version</th></tr></thead><tbody><tr><td><p>Mule</p></td><td><p>4.1.2 and later</p></td></tr><tr><td><p>OpenJDK</p></td><td><p>8 and 11</p></td></tr></tbody></table>

### Fixed Issues

<table><colgroup><col> <col></colgroup><thead><tr><th>Issue</th><th>ID</th></tr></thead><tbody><tr><td><p>Added more error and debug level logging information.</p></td><td><p>FTPC-73</p></td></tr></tbody></table>

## 1.5.4

**June 26, 2021**

### Compatibility

<table><colgroup><col> <col></colgroup><thead><tr><th>Software</th><th>Version</th></tr></thead><tbody><tr><td><p>Mule</p></td><td><p>4.1.2 and later</p></td></tr><tr><td><p>OpenJDK</p></td><td><p>8 and 11</p></td></tr></tbody></table>

### Fixed Issues

Fixed a reconnection issue when a connectivity exception is raised during the poll event. (FTPC-75)

## 1.5.3

**February 2, 2021**

### Minimum Mule Version

**4.1.2**

### Fixed Issues

- Fixed the issue that caused incorrect initialization of streams when connection errors occurred,
  and which caused the streams to remain dirty and resulted in mixed up file contents. (FTPC-70)

- Fixed the issue that caused the move to post-action not to work. (FTPC-67)

## 1.5.2

**August 6, 2020**

### Minimum Mule Version

**4.1.2**

### Fixed Issues

Fixed an issue in which the FTP Connector waited indefinitely for command executions that took too
much time or never ended. The connector now uses the response timeout parameter when executing FTP
commands. (FTPC-57)

## 1.5.1

**January 24, 2020**

### Minimum Mule Version

**4.1.2**

### Fixed Issues

Fixed the issue that caused the connector’s `delete` operation, or any other operation that had the
`lock` or `overwrite` flag set to `true`, to fail. (MULE-17963)

## 1.5.0

**January 10, 2020**

### Minimum Mule Version

**4.1.2**

### Features

Added support to set the control encoding to use in the control channel with the remote server. This
new parameter is located in the **Advanced** tab for any FTPS configuration dialog.

### Fixed Issues

- Fixed an issue where the Write operation was incorrectly throwing a `MULE:UNKNOWN` error instead
  of `FTP:ILLEGAL_PATH`. (MULE-17797)

- Fixed an issue where the connector was showing an incorrect reply code when throwing an FTP error.
  (MULE-17815)

- Fixed the FTP Listener so it is able to rename files on a POST action when `renameTo` is set but
  `moveTo` is left blank. (MULE-17837)

- Fixed a bug where FTP connection timeout was not working if it was set to a very low value.
  (MULE-17867)

## 1.4.2

**October 23, 2019**

### Minimum Mule Version

**4.1.2**

### Fixed Issues

- Improve validations on name and path parameters. (MULE-17680)

## 1.4.1

**September 25, 2019**

### Minimum Mule Version

**4.1.2**

### Fixed Issues

- Fixed an issue where the connector was failing to list or poll directories in some servers.
  (MULE-17434)

- Solved an issue where the FTP Listener was trying to release connections that were never obtained.
  (MULE-17490)

## 1.4.0

**September 4, 2019**

### Minimum Mule Version

**4.1.2**

### Features

- The parameters **Updated in the last**, **Not updated in the last**, and **Time unit** are added
  to the File Matcher. These parameters enable you to have a List or Listener operation that filters
  files by whether or not they have been updated in the specified time unit.

- Adds the option to configure FTP Remote Verification.

### Fixed Issues

- Fixed a bug that made the read operation take more than one connection to read the file content.
  (MULE-17315)

- Allow configuring Remote Verification in FTP config. (MULE-17369)

- Fixed a bug that made the read operation fail for certain FTP servers. (MULE-17347)

- Add **(Not) Updated in the last** capability to File Matcher in the FTP Connector. (MULE-17219)

## 1.3.1

**June 28, 2019**

### Minimum Mule Version

**4.1.1**

### Fixed Issues

- Fixed a bug that caused the connector’s listener to skip a file due to a race condition. When the
  polling frequency of the listener was low, the autodelete flag was true, there was a burst of
  files to process, and the processing of each file took longer than the polling frequency, a file
  could be skipped. (MULE-16999)

## 1.3.0

**May 23, 2019**

### Minimum Mule Version

**4.1.1**

### Features

- The `timeBetweenSizeCheck` setting prevents the connector from processing files while they are
  being written.

### Fixed Issues

- FTP connector should not log the full stack trace in warn level when failing to log out a
  connection. (MULE-16825)

- Fixed a regression that affected the use of `ftp:listener` without specifying a directory.
  (MULE-16818)

## 1.2.6

**April 22, 2019**

### Minimum Mule Version

**4.1.1**

### Fixed Issues

- Fixed an issue that prevented reading a file that had a space in its name. (MULE-16729)

- Fixed an issue that prevented virtual directories to be listed or use the polling source in them.
  (MULE-16625)

## 1.2.5

**March 25, 2019**

### Minimum Mule Version

**4.1.1**

### Fixed Issues

- Improved the FTP Write operation’s performance when writing on remote servers. (MULE-16557)

- Fixed a bug that prevented the usage of the list operation on some FTP server configurations.
  (MULE-16591)

## 1.2.4

**January 21, 2019**

### Minimum Mule Version

**4.1.1**

### Fixed Issues

- Fixed bug that made the List operation take too long when the listed directory contained a large
  number of files. (MULE-16346)

## 1.2.3

**January 4, 2019**

### Minimum Mule Version

**4.1.1**

### Fixed Issues

- Fixed bug that made the connector get stuck while reading files from a remote server, degrading
  performance. (MULE-16291)

## 1.2.2

**July 12, 2018**

### Minimum Mule Version

**4.1.0**

### Fixed Issues

- `FtpFileAttributes` threw NPE when FTPFile date was null. (MULE-15301)

## 1.2.1

**June 15, 2018**

### Minimum Mule Version

**4.1.0**

### Fixed Issues

- FTP:ILLEGAL\_PATH is thrown during FTP write. (MULE-15104)

- FTP:Write deletes the directories and files when no filename is provided. (MULE-15172)

## 1.2.0

**April 24, 2018**

### Minimum Mule Version

**4.1.0**

### Fixed Issues

- FTP connector should better inform on connection errors. (MULE-14993)

## 1.1.1

**February 2, 2018**

### Minimum Mule Version

**4.1.0**

### Fixed Issues

- ftp:listener has undescriptive display name. (MULE-14585)

## 1.1.0

**January 19, 2018**

### Minimum Mule Version

**4.1.0**

### Features

- Added a message source that automatically polls for new files, while handling clustering,
  idempotency, post actions, and watermark automatically.

## See Also

- [Salesforce Help](https://help.salesforce.com)

- [MuleSoft Services](https://www.mulesoft.com/support-and-services)

- [Known Issues](https://help.salesforce.com/s/issues)