> ## Documentation Index
> Fetch the complete documentation index at: https://www.integrate.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# ETL: FTPS Source

> How to connect to an FTPS server and configure the FTPS source component to read files in your Integrate.io ETL pipeline.

The FTPS source reads files from any File Transfer Protocol Secure (FTPS) server and feeds them into your pipeline. It supports CSV, TSV, JSON, Excel, Parquet, Raw, and compressed formats.

Once your connection is set up, see [File Storage Options](https://www.integrate.io/docs/etl/file-storage-options.md) for the full set of read options (file formats, schema, and more) shared across every file storage provider.

## Connection Setup

To allow Integrate.io ETL direct access to your FTPS server, add the Integrate.io [IP addresses](https://www.integrate.io/docs/etl/integrateio-etls-ip-list.md) to your server's firewall allowlist.

**Step 1**

Click the **Connections** icon (lightning bolt) in the top-left menu.

**Step 2**

Click **New connection** and select **File Transfer Protocol Secure (FTPS)**.

![New connection button in the Connections menu](https://mintcdn.com/integrateio/XpeHmuMzUiEmfOEz/images/connectivity-and-security/image-148.webp?fit=max\&auto=format\&n=XpeHmuMzUiEmfOEz\&q=85\&s=c70af74c72f9fdd37440f6dfc4e04c05)

![Selecting FTPS from the connection type list](https://mintcdn.com/integrateio/XpeHmuMzUiEmfOEz/images/connectivity-and-security/image-149.webp?fit=max\&auto=format\&n=XpeHmuMzUiEmfOEz\&q=85\&s=992e2485c02672dda33e61388aafcfc5)

**Step 3**

Name the connection and fill in the connection details:

| Field | Description |
| :- | :- |
| **Hostname** | The hostname of the FTPS server. |
| **User Name** | The username to connect with. Cannot contain the `$` character. |
| **Password** | The password for authentication. Cannot contain the `@` character. |
| **Port** | TCP port of the FTPS server. Default is 21. |

**Step 4**

Click **Test connection** to verify the credentials.

**Step 5**

Click **Create FTPS connection**.

![FTPS connection form with hostname, username, and password fields](https://mintcdn.com/integrateio/XpeHmuMzUiEmfOEz/images/connectivity-and-security/image-150.webp?fit=max\&auto=format\&n=XpeHmuMzUiEmfOEz\&q=85\&s=952652ed0783e47df26eb7e4f8c90b5c)

The connection appears in the connections list.

![FTPS connection created and listed in connections](https://mintcdn.com/integrateio/XpeHmuMzUiEmfOEz/images/connectivity-and-security/image-151.webp?fit=max\&auto=format\&n=XpeHmuMzUiEmfOEz\&q=85\&s=723bffb9a7d82a69fb39fb9202b5d8b0)

### Servers That Allow Only One File Transfer per Session

Some FTPS servers reject a second file operation on a connection that already has one in progress, with the error `The requested operation cannot be performed because there is a file transfer in progress`. This affects **Move processed files to another folder**, which reads each processed file and writes its archive copy over the same connection.

For these servers, set the `single_transfer_per_session` custom property on the connection. The archive step then stages each file in a temporary directory on the cluster, so each hop uses the connection for either a read or a write, never both. The property applies only to SFTP and FTPS connections and is off by default.

The property isn't shown in the connection form. Set it with the [API](https://www.integrate.io/docs/etl/integrateio-etls-api.md):

```bash theme={null}
curl -X PUT \
  -u YOUR_API_KEY: \
  -H "Accept: application/vnd.xplenty+json; version=2" \
  -H "Content-Type: application/json" \
  -d '{"custom_properties": {"single_transfer_per_session": "true"}}' \
  https://api.integrate.io/YOUR_ACCOUNT_ID/api/connections/ftps/CONNECTION_ID
```

The value `true` is accepted in any letter case, with surrounding whitespace ignored. Any other value leaves the connection on the default direct copy.

***

## Source Configuration

### Connection

Select your FTPS connection from the dropdown, or create a new one using the steps above.

### Source Path

The path to the input file, folder, or pattern on the FTPS server. Paths must begin with `/`. Integrate.io prepends the slash automatically if omitted.

| Example | Description |
| :- | :- |
| `/data/sales/2015/01/log.csv` | A single file |
| `/data/sales/2015/01/` | All files in a folder |
| `/data/sales/2015/{01,02}/` | A pattern matching multiple folders |

You can use wildcard characters for [pattern globbing](https://www.integrate.io/docs/etl/using-pattern-matching-in-source-component-paths.md). File and directory names beginning with an underscore (`_`) or a dot (`.`) are ignored.

> [!NOTE]
>
> FTPS has no bucket or container field. The path is relative to the FTPS server root.

<Snippet file="snippets/file-storage-source-format.mdx" />

### Source Action

> [!NOTE]
>
> All four source actions are available for FTPS. When using **Move processed files**, the **Append string to filename** option is supported. If the server allows only one file transfer per connection and archiving fails with `there is a file transfer in progress`, see [Servers That Allow Only One File Transfer per Session](#servers-that-allow-only-one-file-transfer-per-session).

<Snippet file="snippets/file-storage-source-action.mdx" />

<Snippet file="snippets/file-storage-source-tail.mdx" />

***

## FAQ

**How do I allow Integrate.io to connect to my FTPS server?**

Add the Integrate.io [IP addresses](https://www.integrate.io/docs/etl/integrateio-etls-ip-list.md) to your server's firewall allowlist to permit inbound connections.

**My username or password contains a restricted character — what should I do?**

Usernames cannot contain `$` and passwords cannot contain `@`. Contact your server administrator to change the credentials, or use an alternative account.

**Does FTPS support incremental load?**

Yes. Select **Process only new files (Incremental load)** in the source action settings and configure a manifest path. See [reading file storage data incrementally](https://www.integrate.io/docs/etl/how-do-i-read-data-from-file-storage-incrementally.md).

***

## Related

> [card] [FTPS Destination](https://www.integrate.io/docs/etl/using-components-ftps-destination.md)

> [card] [File Storage Options](https://www.integrate.io/docs/etl/file-storage-options.md)

> [card] [Integrate.io IP Address List](https://www.integrate.io/docs/etl/integrateio-etls-ip-list.md)

> [card] [Reading File Storage Data Incrementally](https://www.integrate.io/docs/etl/how-do-i-read-data-from-file-storage-incrementally.md)

> [card] [PGP Keys](https://www.integrate.io/docs/etl/pgp-keys-account-level.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.