Everything in one place

Documentation

Install Ghost FTP on Windows or Linux, configure FTP, FTPS and SFTP connections correctly, and start transferring in the browser version at /ftp.

Download Ghost FTPVersion 2.1.1 RC4 · Windows & Linux · Android soon

Installation

Get the app
running.

Follow the steps for your platform. The whole installation takes a couple of minutes and needs no account.

Install on Windows

  1. Download GhostFTP-Setup-2.1.1-RC4.exe from the Download page.
  2. Compare the published SHA-256 checksum with the downloaded file before you open it.
  3. Run the installer and choose an installation folder. Administrator rights are only needed for a system-wide install.
  4. Choose whether to create a desktop shortcut and whether Ghost FTP should open ftp:// and sftp:// links.
  5. Start Ghost FTP from the Start menu. The first launch creates your local settings folder.

Install on Linux

  1. For Debian and Ubuntu download ghostftp_2.1.1~rc4_amd64.deb and install it with your package manager or with sudo apt install ./ghostftp_2.1.1~rc4_amd64.deb.
  2. For other x86_64 Linux distributions download GhostFTP-linux-x86_64-2.1.1-RC4.
  3. Mark the standalone binary as executable with chmod +x GhostFTP-linux-x86_64-2.1.1-RC4, then run it. No installation or root access is required.
  4. Settings are written to ~/.config/ghostftp, so you can back them up or move them to another machine.
  5. To remove the application, uninstall the .deb package or delete the standalone binary.

Android

  1. The Android version is not currently available. Availability details will be published on the Download page when released.
  2. It will use the same connection profiles and the same security model as the desktop application.

FTP configuration

Set up a connection
that just works.

What every field means, which protocol to choose, and what your server needs to allow.

Connection fields explained

Host is the address of your server (for example ftp.yourdomain.com or an IP address). Port is 21 for FTP and FTPS with explicit TLS, 990 for implicit FTPS and 22 for SFTP. Username and password come from your hosting provider or server administrator. Remote path is optional and lets you open a specific folder, such as /public_html, immediately after connecting.

Choosing a protocol

Use SFTP whenever your server offers it: it runs over SSH on a single encrypted channel and needs no extra firewall rules. Use FTPS with explicit TLS when your server is FTP based but supports encryption. Use plain FTP only on trusted internal networks, because credentials and file contents travel unencrypted. SFTP is available in the desktop application and in the browser gateway when the hosting account provides the PHP SSH2 extension; FTP and FTPS remain available without SSH2.

Key-based authentication

In Site Manager set the authentication method to Key file and select your private key (OpenSSH or PuTTY format). If the key is protected by a passphrase, Ghost FTP asks for it when connecting and can keep it for the current session only. The public key must be present in ~/.ssh/authorized_keys on the server. Keys never leave your computer.

Transfer mode and passive connections

Leave transfer mode on Passive unless your administrator tells you otherwise; passive mode works behind most routers and firewalls. Set the transfer type to Automatic so text files get correct line endings and binaries stay untouched. Concurrent transfers default to two; raise them only if your server allows more sessions. Timeout defaults to 20 seconds and can be increased for slow links.

Saving a site

Open Site Manager, create a new entry, fill in host, port, protocol, username and authentication, then give it a clear name. Optionally set a default local folder and a default remote folder so both panes open where you work. Saved sites can be grouped into folders, duplicated for separate environments, and exported for backup.

Server side requirements

The account must have read and write permission on the folders you use. For websites the document root is usually /public_html, /htdocs or /www. If listings appear empty, check that the account is not locked to a different home folder. For FTPS the server needs a valid TLS certificate; for self-signed certificates Ghost FTP asks you to confirm the fingerprint once.

Browser version

Connecting through /ftp.

The browser version connects to your server through a transient HTTPS-to-FTP/FTPS/SFTP gateway. Credentials are used only for the current request or transfer session and are never written to disk by Ghost FTP.

  1. Open /ftp in your browser. The browser version opens as a standalone application window with no website navigation around it.
  2. Enter the host, username and password, set the port and pick the protocol: SFTP over SSH, FTP, FTPS with explicit TLS, or FTPS with implicit TLS. SFTP requires the PHP SSH2 extension on the hosting account.
  3. Press Quick Connect. The Server Log records every step of the handshake so you can see exactly where a connection fails.
  4. Browse the remote server in the right pane. Use the path field, the parent-folder button and the filter box to move around quickly.
  5. Select a local file in the left pane to upload it, or double-click a remote file to download it. Progress, speed and ETA appear in the Transfer Queue.
  6. Use the toolbar for New Folder, Delete, Rename and Properties. Sites you save are stored in your own browser, always without the password.

Troubleshooting

When something
goes wrong.

Connection times out

The host or port is wrong, or a firewall blocks the connection. Confirm the port with your provider and keep transfer mode on Passive.

Login is rejected

FTP usernames are often the full email address or a prefixed account name. Copy the credentials from your hosting control panel and check for trailing spaces.

Folder listing stays empty

You may be outside your home folder, or the account has no read permission. Type the full path, such as /public_html, in the path field.

Certificate warning on FTPS

The server uses a self-signed or expired certificate. Verify the fingerprint with your administrator before accepting it.

Upload fails part way

Check free disk space and the permissions of the target folder. Failed items stay in the Failed tab of the Transfer Queue and can be retried.

Browser version

The browser gateway supports SFTP only when the hosting account has the PHP SSH2 extension enabled. If SSH2 is unavailable, use FTP/FTPS in the browser or the desktop application for SFTP.