> For the complete documentation index, see [llms.txt](https://docs-v3.toucantoco.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs-v3.toucantoco.com/data-management-in-datahub/datasources-in-toucan/managing-remote-file-storages/setting-up-a-file-storage/sftp.md).

# SFTP

### Requirements

{% hint style="warning" %}
Ensure that your SFTP is opened (port and IP) on your Toucan's workspace.
{% endhint %}

### Configuring a SFTP remote file storage in Toucan

Fill in the connection information after opening the modal of the connector:

### Connection options

File Storage type

* Format: dropdown list among the options available in [Add a file storage](/data-management-in-datahub/datasources-in-toucan/managing-remote-file-storages/setting-up-a-file-storage.md)
* Description: the file storage type you are going to configure
* Example: `SFTP`

**Name** (mandatory)

* Format: String
* Description: A name to identify your connection
* Example: `my_SFTP`

**User** (mandatory)

* Format: String
* Description: Your SFTP login user
* Example: `myuser`

**Host** (mandatory)

* Format: String
* Description: The domain name or IP address of your SFTP server
* Example: `sftp.example.com` or `192.168.1.100`

**Port** (optional, default: 22)

* Format: Integer
* Description: The listening port of your SFTP server
* Example: `22`

**Private Key** (mandatory)

* Format: Secret
* Description: The private SSH key used for authentication
* Example:

```
text-----BEGIN OPENSSH PRIVATE KEY-----
...
-----END OPENSSH PRIVATE KEY-----
```

Prefix (optional)

* Format: String
* Description: the default path to access in your remote file storage

**After Configuration**

Click on Test the connection to test the connection with your SFTP or **SAVE** to save the connection. After successfully configuring the connector, you will be able to find it in the Connector section of the DataHub "Datasources" tab.

### Troubleshooting

* **Connection Issues**: Double-check your SFTP credentials and network access.
* **Need Help**: Reach out to Toucan support or consult the in-app help center for further assistance.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs-v3.toucantoco.com/data-management-in-datahub/datasources-in-toucan/managing-remote-file-storages/setting-up-a-file-storage/sftp.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.