Skip to content

Protocol Overview

Last updated: 2026-05-01 (v3.7.0)

AeroFTP organizes integrations on three tiers, so what you see in the catalog is precise rather than vague:

  1. 7 transport protocols - FTP, FTPS, SFTP, WebDAV, S3, Azure Blob, OpenStack Swift. Native wire-level support, implemented in Rust with full streaming.
  2. 20+ native provider integrations - dedicated OAuth2 / API key / SDK code paths per provider (Google Drive, Dropbox, OneDrive, MEGA, Box, pCloud, Filen, Zoho WorkDrive, Internxt, kDrive, Koofr, Jottacloud, FileLu, Yandex Disk, OpenDrive, 4shared, Drime Cloud, Google Photos, GitHub, GitLab, Immich). Each provider's specific features (sharing, native delta sync, server-side copy, large-file chunking) are first-class instead of best-effort.
  3. 40+ pre-configured presets - server URL, port, base path, password-generation deep-link auto-filled for compatible services on top of the protocols above. Visible in the Discover catalog (S3-compatible endpoints, WebDAV-compatible servers, SourceForge, etc.).

All credentials are encrypted in the AeroFTP Universal Vault (AES-256-GCM + Argon2id). Every integration plugs into AeroSync, AeroAgent, the CLI and the MCP server through the same StorageProvider trait.

Protocol Comparison

Transport Protocols (7)

#ProtocolAuth MethodEncryptionFree Storage
1FTPPasswordNoneN/A (self-hosted)
2FTPSPasswordTLS/SSL (Explicit/Implicit)N/A (self-hosted)
3SFTPPassword / SSH KeySSHN/A (self-hosted)
4WebDAVPassword (Basic + Digest)HTTPSVaries by provider
5S3-CompatibleAccess Key + SecretHTTPS + SSEVaries by provider
6Azure BlobHMAC / SAS TokenHTTPS + SSEPay-as-you-go
7OpenStack SwiftUsername + Password (Keystone v3)HTTPSVaries by provider

Native Provider Integrations (OAuth2 PKCE)

Authenticated through the provider's OAuth2 PKCE flow. AeroFTP opens a browser window for authorization and stores tokens securely in the encrypted vault.

ProviderAuth MethodEncryptionFree Storage
Google DriveOAuth2 PKCEHTTPS + at-rest15 GB
DropboxOAuth2 PKCEHTTPS + at-rest2 GB
OneDriveOAuth2 PKCEHTTPS + at-rest5 GB
BoxOAuth2 PKCEHTTPS + at-rest10 GB
pCloudOAuth2 PKCEHTTPS + at-rest10 GB
Zoho WorkDriveOAuth2 PKCE (8 regional endpoints)HTTPS + at-restTeam plan
KoofrOAuth2 PKCEHTTPS + at-rest10 GB
Yandex DiskOAuth2 TokenHTTPS5 GB
InternxtOAuth2 PKCE + zero-knowledgeClient-side AES-256-CTR1 GB
4sharedOAuth 1.0 (HMAC-SHA1)HTTPS15 GB

Native Provider Integrations (API Key / Token / Session)

Direct authentication via API keys, session tokens, or personal access tokens. No browser-based OAuth flow required.

ProviderAuth MethodEncryptionFree Storage
MEGAPassword (Native API or MEGAcmd)Client-side AES20 GB
FilenPassword (PBKDF2) + optional 2FAClient-side AES-256-GCM10 GB
kDriveAPI Token (Bearer)HTTPS15 GB
JottacloudPersonal Login Token (auto-refresh 60s pre-expiry)HTTPS5 GB
Drime CloudAPI Token (Bearer)HTTPS20 GB
FileLuAPI KeyHTTPS1 GB
OpenDriveSession Auth (user/pass)HTTPS5 GB

Native Provider Integrations (Developer Platforms)

ProviderAuth MethodEncryptionNotes
GitHubOAuth2 / PAT / App .pem (vaulted, AES-256-GCM)HTTPSRepository as filesystem; every upload/delete is a real Git commit
GitLabPATHTTPSRepository as filesystem
ImmichAPI Key (x-api-key)HTTPSSelf-hosted photo library; media-only writes

Protocol Categories

Transport Protocols (Self-Hosted)

These connect to servers or buckets you control. You provide the hostname, port, and credentials.

  • FTP - Traditional unencrypted file transfer. Suitable for legacy servers and shared hosting on trusted networks.
  • FTPS - FTP secured with TLS/SSL. Supports both Explicit (STARTTLS on port 21) and Implicit (port 990) modes. AeroFTP detects TLS downgrade attempts and warns the user.
  • SFTP - Secure file transfer over SSH. The recommended choice for self-hosted servers. Supports password and SSH key authentication with TOFU host key verification. Eligible for delta sync via AeroRsync when key-auth + remote rsync are present.
  • WebDAV - HTTP-based file access over HTTPS. Used by Nextcloud, Seafile, and many NAS devices. Supports Basic and Digest authentication.
  • S3 - Object storage using the S3 API. Works with AWS, Wasabi, Backblaze B2, and any S3-compatible endpoint.
  • Azure Blob - Enterprise object storage with HMAC signing or SAS tokens.
  • OpenStack Swift - Object storage using the OpenStack Swift API. Works with Blomp, OVH, Rackspace, and any Swift-compatible endpoint. Authenticates via Keystone v3 or TempAuth.

Native Provider Integrations

Each native provider has its own dedicated code path so its specific features (sharing, native delta sync, server-side copy, large-file chunking, trash management, versioning, labels) are first-class instead of best-effort.

OAuth2 PKCE flow: Google Drive, Dropbox, OneDrive, Box, pCloud, Zoho WorkDrive, Koofr, Yandex Disk, Internxt. OAuth 1.0 (HMAC-SHA1): 4shared (RFC 5849). Direct auth (API key / token / session): MEGA, Filen, kDrive, Jottacloud, Drime Cloud, FileLu, OpenDrive. Developer platforms: GitHub, GitLab, Immich, SourceForge.

Highlights:

  • MEGA - Zero-knowledge E2E encryption with client-side AES.
  • Filen - E2E encrypted with PBKDF2 key derivation and AES-256-GCM. Optional 2FA.
  • Internxt - E2E encrypted with PBKDF2 + BIP39 mnemonic and AES-256-CTR.
  • Drime Cloud - 20 GB secure cloud storage with file versioning, server-side copy, and share links.
  • FileLu - File/folder password protection, privacy controls, server-side clone, trash management, remote URL upload.
  • GitHub - Repository as filesystem - every upload/delete is a real Git commit. PAT keys are encrypted (AES-256-GCM) in the vault on import. Token expiry badges and protected-branch PR creation.

WebDAV Presets

AeroFTP includes pre-configured WebDAV presets for popular services:

ServiceEndpointDefault PortFree StorageNotes
Nextcloudyour-server.com/remote.php/dav/files/USERNAME/443Varies (self-hosted)Most popular self-hosted cloud
Seafileyour-server.com/seafdav443Varies (self-hosted)Via SeafDAV extension
CloudMewebdav.cloudme.com4433 GBSwedish cloud storage
Jianguoyundav.jianguoyun.com/dav4432 GBChinese market (Nutstore)
InfiniCLOUDwebdav.teracloud.jp/dav/44320 GBJapanese cloud by InfiniCloud

When using a WebDAV preset, AeroFTP automatically configures the endpoint path. You only need to provide your server hostname and credentials.

S3-Compatible Presets

AeroFTP supports any S3-compatible service. Built-in presets auto-configure the endpoint and region:

ServiceEndpoint TemplateFree TierNotes
AWS S3s3.{region}.amazonaws.comPay-as-you-goThe original S3
Wasabis3.{region}.wasabisys.comPay-as-you-goNo egress fees
Backblaze B2s3.{region}.backblazeb2.com10 GBS3-compatible API
DigitalOcean Spaces{region}.digitaloceanspaces.comPay-as-you-goCDN included
Cloudflare R2{accountId}.r2.cloudflarestorage.com10 GBNo egress fees, requires Account ID
Storjgateway.storjshare.io25 GBDecentralized storage
Alibaba OSSoss-{region}.aliyuncs.comPay-as-you-goAsia-optimized
Tencent COScos.{region}.myqcloud.comPay-as-you-goChina regions
MinIOCustom endpointN/ASelf-hosted S3
Yandex Object Storagestorage.yandexcloud.netPay-as-you-goRussia region

For Cloudflare R2, a dedicated Account ID field is shown in the connection form. The endpoint is computed automatically from the account ID.

Feature Matrix

Trash Management

Not all providers expose a trash/recycle bin API. The following table shows which protocols support trash operations in AeroFTP:

ProtocolList TrashRestorePermanent DeleteEmpty Trash
Google DriveYesYesYesNo
DropboxYesYesYesNo
OneDriveYesYesYesNo
BoxYesYesYesNo
pCloudYesYesYesYes
Zoho WorkDriveYesYesYesNo
KoofrYesYesNoYes
MEGAYesYesYesNo
kDriveYesYesYesYes
JottacloudYesYesYesNo
InternxtYesNoNoNo
FileLuYesYesYesNo
Yandex DiskYesYesYesYes
OpenDriveYesYesYesYes
All othersNoNoNoNo

File Versioning

ProtocolList VersionsDownload VersionRestore Version
Google DriveYesYesYes
DropboxYesYesYes
OneDriveYesYesYes
BoxYesYesYes
pCloudYesYesYes
Zoho WorkDriveYesYesYes
KoofrYesYesYes
kDriveYesYesYes
Drime CloudYesYesYes
S3-CompatibleYes (if bucket versioning enabled)YesYes
All othersNoNoNo
ProtocolCreate Share LinkExpiring LinksPassword-Protected
Google DriveYesNoNo
DropboxYesYes (Pro)Yes (Pro)
OneDriveYesYesYes
BoxYesYesYes
pCloudYesNoNo
Zoho WorkDriveYesNoNo
KoofrYesNoNo
FilenYesNoNo
kDriveYesNoNo
JottacloudYesNoNo
Drime CloudYesNoNo
FileLuYesNoYes
Yandex DiskYesNoNo
OpenDriveYesYes (expiring)No
S3-CompatiblePre-signed URLsYes (time-limited)No
Azure BlobSAS tokensYes (time-limited)No
MEGAYesNoNo
WebDAV (Nextcloud)YesNoNo
GitHubPermalink URLsNoNo
All othersNoNoNo

Tags and Labels

ProtocolAdd TagsRemove TagsList Tags
BoxYesYesYes
DropboxYesYesYes
Zoho WorkDriveYes (team labels)YesYes
Google DriveYes (properties)YesYes
All othersNoNoNo

Integration Compatibility

AeroSync

AeroSync supports bidirectional synchronization across all 7 transport protocols and the 20+ native provider integrations. AeroCloud background sync classifies providers by reliability through maturity badges visible in the setup wizard.

AeroSync features available across the entire surface:

  • Bidirectional and unidirectional sync (Mirror, Two-Way, Backup, Pull, Remote Backup)
  • Conflict resolution (keep local, keep remote, keep newer, skip, rename)
  • Transfer journal with checkpoint/resume
  • Post-transfer verification (size, mtime, SHA-256)
  • Configurable retry with exponential backoff
  • Bandwidth throttling
  • Dry-run mode with JSON / CSV export
  • Delta sync via AeroRsync - eligible SFTP sessions transfer only the bytes that differ; cross-OS first-class on Linux/macOS/Windows since v3.6.1

CLI Support

All 7 transport protocols and 20+ native provider integrations are accessible from the aeroftp-cli command-line tool using either direct URL connections or saved vault profiles:

bash
aeroftp-cli ls sftp://user@myserver.com/path/
aeroftp-cli get s3://mybucket/file.txt
aeroftp-cli put ftp://user@host/upload/ ./local-file.txt
aeroftp-cli sync ftp://user@host/ ./local-dir/
aeroftp-cli tree webdav://user@nextcloud.example.com/remote.php/dav/files/user/
aeroftp-cli ls --profile "My Google Drive" /     # OAuth provider via vault profile

The CLI ships 49+ subcommands including: connection (connect, ls, get, put, pget, mkdir, rm, mv, cp, cat, head, tail, touch, hashsum, check, stat, find, df, about, tree, link, edit, rcat), sync (sync, sync --watch, reconcile, sync-doctor, dedupe, cleanup), cross-profile (transfer, transfer-doctor), benchmarking (speed, speed-compare), local servers (serve http/webdav/ftp/sftp), filesystem (mount, ncdu, crypt), automation (batch, daemon, jobs, alias, completions), import (import rclone/winscp/filezilla), agent surface (agent, mcp, agent-bootstrap, agent-connect, agent-info, ai-models, profiles).

Batch scripting via .aeroftp files, glob pattern transfers, structured --json output, semantic exit codes (0–11), and NO_COLOR compliance. See CLI Commands for the full reference.

AeroAgent server_exec

AeroAgent can execute file operations on saved servers through the server_exec tool. This tool resolves credentials from the vault in Rust and never exposes passwords to the AI model.

CategoryProtocolsserver_exec Support
Server ProtocolsFTP, FTPS, SFTP, WebDAV, S3, SwiftYes
Direct Auth CloudMEGA, Azure, 4shared, Filen, Internxt, kDrive, Jottacloud, Drime Cloud, FileLu, Yandex Disk, OpenDriveYes
OAuth CloudGoogle Drive, Dropbox, OneDrive, Box, pCloud, Zoho WorkDrive, KoofrBlocked (requires browser OAuth)
DeveloperGitHub, SourceForgeGitHub: Blocked (requires browser OAuth or manual PAT). SourceForge: Yes (via SFTP)

The server_exec tool supports 10 operations: ls, cat, get, put, mkdir, rm, mv, stat, find, and df. Server names are matched with fuzzy matching against saved server profiles.


Last updated: 2026-05-01 - AeroFTP v3.7.0

aeroftp.app - Released under the GPL-3.0 License. AeroFTP Reviews