--- title: "Configuring the SFTP" slug: "configuring-the-sftp" updated: 2026-01-08T14:30:02Z published: 2026-01-08T14:30:02Z canonical: "docs.relaynetwork.com/configuring-the-sftp" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.relaynetwork.com/llms.txt > Use this file to discover all available pages before exploring further. # Configuring the SFTP The SFTP connection can be configured within CX Builder by any user with Client Admin or Client User with Integration permissions in the system. This feature is available in both the Staging and Production environments. > [!WARNING] > Prerequisites > > To complete the steps below, you need to generate a pair of SSH2 keys. For instructions on creating SSH2 keys, you can reference the [Generating SSH2 Keys](/docs/creating-ssh2-keys) page. ## Adding a New Integration | Step # | Description | CX Builder | | --- | --- | --- | | 1 | Once you are signed in, click on the **SFTP & GPG in the left menu column. Remain on the Relay Hosted SFTP** tab. This is the “home page” of the connections to the Relay SFTP site. Note: If you do not see the SFTP & GPG module on the left menu, please check that you have either Client Admin or Client User with Integration Permissions in the system. | ![](https://cdn.us.document360.io/6738087b-455d-402f-b70a-a44a4231547e/Images/Documentation/Screenshot 2025-06-17 at 12.02.35 PM.png) | | 2 | Locate the Public SSH2 key you created for the connection, and copy and paste the contents of the key into the **SSH key contents box, and then click Upload below it.** Note: If your key does not start with “---- BEGIN SSH2 PUBLIC KEY ----” then you will need to convert it from standard SSH format to SSH2 format. This can be done by clicking on the carrot to the right for instructions on how to create a converted key before loading it into the SSH key contents box. | ![](https://cdn.us.document360.io/6738087b-455d-402f-b70a-a44a4231547e/Images/Documentation/Screenshot 2025-06-17 at 12.19.22 PM.png) | | 3 | Once the key is successfully loaded, it will be listed on the main screen as shown to the right. To test connectivity to the SFTP, you will authenticate with your username and the private SSH2 key you created. The username is listed next to “SFTP keys for:” within the UI. | ![](https://cdn.us.document360.io/6738087b-455d-402f-b70a-a44a4231547e/Images/Documentation/Screenshot 2025-06-17 at 12.27.44 PM.png) | | 4 | **Automated File Processing - ON or OFF** Once a file is loaded to the appropriate Relay SFTP folder, it will automatically be processed by the system. To turn this feature off and have the file stay in idle status for manual processing/scheduling, toggle the switch to OFF in the right hand corner. | ![](https://cdn.us.document360.io/6738087b-455d-402f-b70a-a44a4231547e/Images/Documentation/Screenshot 2025-06-17 at 12.27.44 PM(1).png) | | 5 | **Adding Additional Connections** Relay can support multiple connections to the SFTP site. To add an additional SSH2 key, click on **Add SFTP Key above the current key.** This will take you back to Step 2 where you can copy the contents of the key into UI. | ![](https://cdn.us.document360.io/6738087b-455d-402f-b70a-a44a4231547e/Images/Documentation/Screenshot 2025-06-17 at 12.27.44 PM(2).png) | | 6 | **Deleting Old Connections** To delete an old or expired SSH2 key, click on the trash can icon to the right. | ![](https://cdn.us.document360.io/6738087b-455d-402f-b70a-a44a4231547e/Images/Documentation/Screenshot 2025-06-17 at 12.27.44 PM(3).png) | ## Adding a GPG Key for Encryption | Step # | Description | CX Builder | | --- | --- | --- | | 1 | Once you are signed in, click on the **SFTP & GPG in the left menu column. Click on the File Encryption** tab. This is the “home page” of the connections to the Relay SFTP site. Note: If you do not see the SFTP & GPG module on the left menu, please check that you have either Client Admin or Client User with Integration Permissions in the system. | ![](https://cdn.us.document360.io/6738087b-455d-402f-b70a-a44a4231547e/Images/Documentation/Screenshot 2025-07-15 at 12.19.43 PM.png) | | 2 | Locate the Public GPG key you created for encryption, and click on **Select GPG Key File, choose the file from your computer.** | ![](https://cdn.us.document360.io/6738087b-455d-402f-b70a-a44a4231547e/Images/Documentation/Screenshot 2025-07-15 at 12.27.16 PM.png) | | 3 | Once the key information has successfully populated on the screen as shown to the right, click on **Submit.** The reports you receive from Relay from the pickup/report folder will now be encrypted with this public key. To decrypt the file, please use the private GPG stored in your system. | ![](https://cdn.us.document360.io/6738087b-455d-402f-b70a-a44a4231547e/Images/Documentation/Screenshot 2025-07-15 at 12.24.39 PM.png) | | 4 | **Deleting a GPG key** To delete an old or expired GPG key, click on the Delete button at the bottom of the key information screen. | ![](https://cdn.us.document360.io/6738087b-455d-402f-b70a-a44a4231547e/Images/Documentation/Screenshot 2025-07-15 at 12.26.09 PM.png) |