---
title: FTP Download
description: "Download a file from an FTP server over the SIM's data connection and measure throughput, to compare protocols or match FTP-based benchmarks."
lastUpdated: "2026-09-23"
---

> **For AI agents:** the complete documentation index is at [llms.txt](/llms.txt). Append `.md` to any page URL for its markdown version.

Download a file from an FTP server over the SIM's data connection and measure throughput. Useful when your benchmark infrastructure is FTP-based or to compare protocols on the same network.

## Parameters

| Parameter | Required | Description |
| ----------- | ---------- | ------------- |
| Download link | Yes | FTP URL of the file. |
| Download size limit | No | Stop after this many bytes. |
| FTP credentials | No | Login for the FTP server. |
| Download should fail | No | Invert the verdict. |

Plus the shared [connection settings](/tests/actions/cellular/overview#connection-settings) and DNS override (`command.override_dns`, `command.dns`).

## Results and metrics

In the action report (`result`): `throughput_in_kbps`, `md5sum` (file integrity), `dns_server`, and `duration` in seconds.

In Analytics, each run feeds the FTP download measurement with `throughput_kbps` and `duration_seconds`, tagged by status, URL, APN, antenna, and access technology.

## What's next?

<Columns cols={2}>
  <Card title="FTP Upload" icon="cloud-arrow-up" href="/tests/actions/cellular/ftp-upload">

    The uplink direction

</Card>
  <Card title="Download File" icon="cloud-arrow-down" href="/tests/actions/cellular/download-file">

    The HTTP equivalent, with the timing waterfall

</Card>
</Columns>