> For AI agents: the complete documentation index is available at https://www.jumpserver.com/docs/llms.txt, the full documentation bundle is available at https://www.jumpserver.com/docs/llms-full.txt.

# File Transfer

**File Transfer** lists the file operations performed through JumpServer sessions, including uploads, downloads, deletes, and renames. Use it to confirm which files moved between a user and an asset, and to retrieve a retained file when file storage is enabled.

Open the page from **Audits > Sessions > File Transfer**.

## Overview

Each row records the user, asset, account, operation, file name, start time, and result. The row action **Download** retrieves the stored file when the file was retained. The toolbar provides search, a date range, column settings, export, and refresh.

## Prerequisites

- Sign in with an account that has the `audits.view_ftplog` permission, such as a system administrator or auditor.
- At least one file operation must have been performed through JumpServer.
- File storage and file retention must be enabled before files can be stored and downloaded from this page.

## Review and retrieve transfers


1

Filter the list by date range, or search for a user, asset, or file name.

2

Check the **Operate** and **Success** columns to confirm the direction and result of the transfer.

3

Click **Download** in the row actions to retrieve a retained file.

![Figure 1: File Transfer list with user, asset, account, operation, file name, and result columns.](/images/v5/jumpserver/v5_admin_ftp_01.png)

## Customize columns and export

Open **List preferences**, select the extra columns you need, and click **Confirm**. Extra columns include ID, remote address, organization ID, download availability, and session. **Restore defaults** resets the list.

![Figure 2: List preferences for file transfer records.](/images/v5/jumpserver/v5_admin_ftp_02.png)

Click **Export**, choose **CSV** or **Excel**, then select **Export all**, **Export selected**, or **Export search results**, and click **Confirm**.

## Field reference

| Field          | Description                                                  |
| -------------- | ------------------------------------------------------------ |
| User           | User who performed the file operation.                       |
| Asset          | Asset involved in the transfer.                              |
| Account        | Account used for the connection.                             |
| Operate        | Operation type, such as upload, download, delete, or rename. |
| Filename       | Name of the transferred file.                                |
| Start date     | When the operation started.                                  |
| Success        | Whether the operation completed successfully.                |
| Download       | Retrieves the retained file when available.                  |
| Remote address | Optional. Source address of the client.                      |
| Session        | Optional. Related session record.                            |

## Notes


Note

The **Download** action is available only when file storage is enabled and the file is still retained. If file storage is disabled or the retention limit was reached, the record remains visible but the file cannot be retrieved. Configure retention in [Storage](https://www.jumpserver.com/docs/features/system-settings/infrastructure/storage.md).

## Related topics

- [Asset Sessions](https://www.jumpserver.com/docs/features/audits/sessions/asset-sessions.md)
- [Session Commands](https://www.jumpserver.com/docs/features/audits/sessions/session-commands.md)