Installation

AeroFTP is available for Linux, Windows, and macOS. All packages are built in a clean GitHub Actions CI environment and distributed through GitHub Releases. AeroFTP is free and open-source with no license keys, subscriptions, or telemetry.

Supported Platforms

Platform	Formats	Install Method
Linux	`.deb`, `.rpm`, `.AppImage`, `.snap`, AUR	Package manager, Snap Store, or direct download
Windows	`.msi`, `.exe`	MSI installer (recommended) or NSIS executable
macOS	`.dmg`	Drag to Applications

System Requirements

Requirement	Minimum	Recommended
Disk space	~120 MB installed	200 MB (including cache)
RAM	256 MB	512 MB or more
OS (Linux)	Ubuntu 22.04, Fedora 38, Arch (current)	Ubuntu 24.04+ or equivalent
OS (Windows)	Windows 10 (1709+)	Windows 11
OS (macOS)	macOS 12 Monterey	macOS 14+
Linux runtime	WebKitGTK 4.1 (`libwebkit2gtk-4.1`)	Included in most desktop distributions

Note: On Linux, AeroFTP requires the WebKitGTK 4.1 runtime library. Most desktop distributions (Ubuntu, Fedora, Arch with a desktop environment) include it by default. See the Linux installation guide for manual installation commands if needed.

Choose Your Platform

Linux -- .deb, .rpm, .AppImage, Snap Store, or AUR (Arch)
Windows -- .msi installer (recommended) or .exe NSIS bundle
macOS -- .dmg disk image

Downloading

All releases are published on the GitHub Releases page. Each release includes:

Platform-specific installers and packages
A changelog describing all changes in the release
SHA-256 checksums for every artifact

To download the latest version, visit the Releases page and select the appropriate file for your platform and architecture.

Verifying Downloads

All release artifacts are built by GitHub Actions in a reproducible CI environment. To verify the integrity of a downloaded file, compare its SHA-256 checksum against the value published on the Releases page:

# Linux / macOS
sha256sum aeroftp_3.0.1_amd64.deb

# Windows (PowerShell)
Get-FileHash .\AeroFTP_3.0.1_x64-setup.msi -Algorithm SHA256

If the checksum matches the value listed on the GitHub Releases page, the file has not been tampered with during download.

Auto-Update

AeroFTP includes a built-in update checker that runs every 24 hours. When a new version is available, a non-intrusive notification appears with the option to download and install the update.

AppImage (Linux): Full auto-update support. The app downloads the new AppImage, backs up the current version, replaces it, and restarts automatically.
Snap (Linux): Updates are handled automatically by the Snap daemon.
.deb / .rpm (Linux): The app downloads the new package and applies it using Polkit-authenticated system commands.
Windows / macOS: The app notifies you of the update and provides a download link.

File Associations

AeroFTP registers itself as the handler for .aerovault encrypted container files. Double-clicking an .aerovault file in your operating system's file manager will open it directly in AeroFTP's vault browser.

Next step: Once installed, follow the Quick Start guide to connect to your first server.

AeroFTP Documentation