This documentation attempts to explain installation of the FileZilla FTP and SFTP Client.
FileZilla comes in three versions. There is an installer version that offers ease of installation and uninstallation for novice users, a zipped version for people that don't like installers or have special needs, and then for the advanced user there is a source version which lets you take a look at, modify and/or compile the source code of FileZilla.
Don't worry if you find this confusing, I'll get back to each of them in depth later in this document and try to help you choose which one you need.
IMPORTANT NOTE: It is _strongly_ recommended that you only download FileZilla from the official source to avoid viruses and spyware. There have been unofficial versions of FileZilla that contained viruses and spyware on sites like download.com, so don't use them! Also, I recommended to always get the latest version of FileZilla regardless of which version this documentation or the download page was based on!
Choosing the right download
As I said earlier, there are three different FileZilla versions you can download. Basically they are all the same, they are just presented to you differently. I will now try to explain each of them before we start downloading FileZilla in the next section.
As a novice user the installer version is the safe and easy choice. With this version you only need to download the file, run it and the program will get installed by itself. If you don't know which version to get, this is probably the one you want. However, if you don't have sufficient rights to install programs on the computer you are using (e.g. at work or at school) the zip version is the way to go. If you've already decided to go for the installer version, you can go directly to downloading.
Note: The installer version is not available for Linux or Mac.
If you have special needs, don't have sufficient rights to install programs or don't like installers, the zip version is there for you. A zip-file is a file that contains files inside of it. They are packed into one file and you need to unpack (unzip) them to use them. To do this you need a zip program (or if you are running Windows XP there's a simple unzipper included in the operating system). If you need such a program I can recommend the free and open source based program 7-zip.
TIP: If you want to put FileZilla on a USB stick so you can take your copy of FileZilla with all its settings wherever you go, the zip version is the best bet. Note there are additional steps required to make it portable.
Source code version
This is for the advanced user who wants to take a look at or modify the source code of FileZilla. You can find compiling instructions on this wiki. The page is outdated and incomplete but it'll give you a general idea. You will have to check out the forum (Main forum) to get more information.
By now you should have made up your mind on which version you want to download. If not, go back to choosing the right download and make a decision.
Choosing the appropriate version
Now it's time to head over to the download section. Click this link (if you right-click it and choose Open in new window you can still follow this guide while downloading) and then wait for the page to load.
Still remember which version you want to get? You now need to download the correct file, the download page will help you with this. Choose between installer, zip or source code version. Next, click the link you want.
Downloading the file
You will now get to a new page which should look something like the picture below:
If the download does not start automatically after a few seconds, click on the link labeled direct link.
Sometimes the mirror chosen for the download is unavailable. You can select a different mirror by clicking on Select a different mirror.
Saving and running
Depending on which browser you are using you will (normally) see a window where you can decide what to do with the file you are downloading. The easiest way is just to hit run or open and the file will download and then be run. As FileZilla does not contain a software signature/certificate, you might get some warning messages telling you that you are running a potentially dangerous file downloaded from the Internet, but let me assure you, Sourceforge is a reliable download source and it shouldn't be any problem. If you are familiar with how to save the file and would like to do that, go ahead. Just remember to save it where you can easily find it afterwards and then open it from there :) On Windows Vista, 7 or 8, you might need to confirm an additional UAC prompt to start the installer.
Hopefully after the file downloads you will have started the FileZilla installer if you went for the installer version or opened the zip file in a zip program for any other version. In the next section I'll help you through the installation process.
Installing on Windows
With installer version
Please note: All screenshots are from Windows 8. Yours may look different, but the functionality is the same.
Make sure that the user account which is being used for the installation has administrative rights that allow the installation of software.
Possible Confirmation prompts
Depending on OS settings and version, it is possible that one or both of the following confirmation prompts appear:
Hopefully you should now see the following window where you will have to accept the terms of the license agreement to continue. Read through it and click 'I Agree' if you do.
Installing for me or all users?
You will now have to decide if you want to install only for your user account or if FileZilla should be accessible by every user on the machine. This mainly affects where the Start Menu icons are placed. Installing for all users needs administrative privileges, and every user will have his/her own settings.
Next you need to choose which parts of the FileZilla client you want to install. If you hover your mouse over a choice, FileZilla will show you a description of the item. Here is the window:
Go through all of them and just check/uncheck the stuff you want. Select additional languages if you want FileZilla in another language than English. Icon sets let you choose different looks for FileZilla's icons (they are partly user contributed). The shell extension integrates FileZilla into the Windows Explorer. Most users will go with what's selected by default here. When you're all finished, click Next.
The next window will ask you where to install the program. If you don't have any special needs, click Next.
The default path is to install into your 'Program Files' directory on 32bit Windows, and into 'Program Files (x86)' on 64bit Windows. Please, if you are migrating from FileZilla 2, do NEVER, EVER install into the same directory as FileZilla 2! FileZilla 3 is not an upgrade to FileZilla 2, and merging both directories creates a mess.
Start menu shortcuts
Here, you will be asked what you want to name the folder with the shortcuts to FileZilla inside. The default name 'FileZilla FTP Client' should be good for most people. You can also choose not to install these shortcuts.
Note to Windows 8 users: In Windows 8, MS has removed the Start Menu, but if you install the one from ClassicShell you will get your Start menu icons back.
When you click Install, FileZilla will get installed.
If no errors occur it should complete in some seconds.
When it's done, click Next to finish the installation.
Congratulations, you've now successfully installed the FileZilla Client and can now move on to running!
With zip version
Installation with the zip version is very simple as long as you know how to work with zip files and can manage general file and directory handling in Windows. Basically you just extract (unzip) the downloaded file to a folder on your disk, e.g. 'C:Program FilesFileZilla FTP Client' and then just start FileZilla with the filezilla.exe file afterwards. Please note that this action requires Elevation on Windows Vista/7/8! It might be a good idea to make a shortcut to this file on your desktop/start menu/quick launch so that you can easily access it.
To create a portable installation of FileZilla on a USB stick or any other portable storage, you first have to extract the ZIP file contents to that location. Then, you must create a file named 'fzdefaults.xml' in the same directory as the FileZilla executable. There's an example file in the './docs' subdirectory you can use as template. Follow the included instructions in the example file to set the config location to a relative path on your portable device.
Installing on Mac OS X
Please note that the official binaries for FileZilla require OS X 10.9 or greater.
To install FileZilla, simply download the appropriate file to your computer.
If you have downloaded the FileZilla package using Safari, it will be automatically extracted. You might have to manually extract the archive if you're using a different browser. To start FileZilla, simply doubleclick the extracted application bundle.
Covered Top of FileZilla-Window by MacOS-Menu
When you start FileZilla in the Finder, then you will see that the window of FileZilla is covered by the top menu. You may find it difficult to move the window, because you cannot click on the covered top of the FileZilla-window. Tip: You can resolve this problem by changing the resolution of your screen and then change it back to the original resolution (during the resolution change, OSX re-checks that all windows are properly oriented).
Installing on GNU/Linux and other Unix(-like) systems
It is recommended that you use the package manager of your distribution.
If you're using GNU/Linux, you can also try using the precompiled binaries. After extracting the files to any location (location does not matter, FileZilla can detect its own installation prefix), you can start the program using the filezilla executable in the bin/ subdirectory. Please note that due to differences in distributions, the provided binaries might not work on your system.
Alternatively you can also compile FileZilla from source.
Compiling FileZilla from source
You can find compiling instructions on this wiki. If you have questions regarding the compilation have a look at the forums.
FileZilla is simply run by double-clicking the FileZilla.exe file (default location for Windows: 'C:Program FilesFileZilla FTP ClientFileZilla.exe') or one of the shortcuts on the desktop or in the start menu that you may have created during the installation of FileZilla. There are command line arguments you can use.
At the first start of each version a short version introduction appears (unless you use Kiosk Mode 2).
For an example screenshot of a first start, click here:FileZilla First start
Download FileZilla Client 22.214.171.124 for Mac OS X. The latest stable version of FileZilla Client is 126.96.36.199. Please select the file appropriate for your platform below. FileZilla® is a cross-platform FTP, SFTP, and FTPS client with a vast list of features, which supports Windows, Mac OS X, Linux, and more. FileZilla's dynamic tools help you move files between your local machine and your Web site's server effortlessly.
|#10947||In filenames Filezilla replaces German umlaut with normal letter + diaresis marker||new||Bug report||critical||FileZilla Client|
|#11764||'Successful' transfer files not appearing on remote site||new||Bug report||critical||FileZilla Client|
|#11913||You need to grant FileZilla Access to the directories .... Cant get past this!||new||Bug report||critical||FileZilla Client|
|#12117||macOS Catalina UI bug prevents usage||new||Bug report||blocker||FileZilla Client|
|#5407||retain permission settings||new||Feature request||high||FileZilla Client|
|#7364||Keyboard shortcuts for Mac!!!!||new||Feature request||high||FileZilla Client|
|#7749||FileZila unusable with network drives||new||Bug report||high||FileZilla Client|
|#7768||When updating filezilla.app.. the program wont open, the icon bounces & console says theres a permissions problem||new||Bug report||high||FileZilla Client|
|#8225||Shell scripts files permission changed after downloaded from remote site.||new||Bug report||high||FileZilla Client|
|#8375||FileZilla Spazzed Out and Started Deleting Everything||new||Bug report||high||FileZilla Client|
|#8603||MAC OC 10.8.3 - KEYBOARD DELETE KEY NOT FUNCTIONAL||new||Bug report||high||FileZilla Client|
|#9097||File name comparison error for Arabic files||new||Bug report||high||FileZilla Client|
|#9884||Folders which are created by another user are not downloaded||new||Bug report||high||FileZilla Client|
|#9977||OS X: Keyboard mnemonics on buttons override default edit control actions (e.g. Cmd+V)||assigned||Bug report||high||FileZilla Client|
|#10086||OSX autoupdate fails||new||Bug report||high||FileZilla Client|
|#10794||FileZilla does not combine unicode characters||new||Bug report||high||FileZilla Client|
|#10834||Unable to resize FileZilla window on Mac||new||Bug report||high||FileZilla Client|
|#10875||Feature Request||new||Feature request||high||FileZilla Client|
|#11112||filename comparison and file transfer logic don't match when filename has diacritics||new||Bug report||high||FileZilla Client|
|#11184||folders or files selection impossible during work||new||Bug report||high||FileZilla Client|
|#11236||dialog window position on dual monitor issue||new||Bug report||high||FileZilla Client|
|#11246||'Locate file in Finder' or 'Locate file in Explorer'||new||Feature request||high||FileZilla Client|
|#11265||Mac OS Sierra bug with top||moreinfo||Bug report||high||FileZilla Client|
|#11342||unable to log in||new||Bug report||high||FileZilla Client|
|#11729||MAC OS X SIte Manager Sroll overlap entries||reopened||Bug report||high||FileZilla Client|
|#11756||Issues using Filezilla on macOS Mojave||new||Bug report||high||FileZilla Client|
|#11770||Cannot open subdirectories in directory tree after updating||reopened||Bug report||high||FileZilla Client|
|#11771||Implement dark mode in macOS Mojave||new||Bug report||high||FileZilla Client|
|#11874||SFTP servers denying access because of so many keys being sent||new||Bug report||high||FileZilla Client|
|#11887||Incorrect Password||new||Other||high||FileZilla Client|
|#12018||Upload Edited Files - Long Response Time||new||Bug report||high||FileZilla Client|
|#12121||Creating a new folder forces directory to go up a level||new||Bug report||high||FileZilla Client|
|#12145||Dialogue boxes extremely slow on Mac, 188.8.131.52||new||Bug report||high||FileZilla Client|
|#12307||[Patch] Auto-update proposal||reopened||Patch||high||FileZilla Client|
|#4759||File Permissions Dialog - Request to have numeric positions highlighted when opened||new||Feature request||normal||FileZilla Client|
|#5046||Local Transfer Management||new||Feature request||normal||FileZilla Client|
|#5094||Move cursor to end of file path box upon failing to change directory||new||Feature request||normal||FileZilla Client|
|#5148||E-mail notifications||new||Feature request||normal||FileZilla Client|
|#5178||Mac OSX: Close Button should Hide not Close App||new||Feature request||normal||FileZilla Client|
|#5302||OSX - Cannot recognise OSX folder aliases||new||Bug report||normal||FileZilla Client|
|#5676||Shortcut CMD+ARROW_DOWN on MacOSX||new||Feature request||normal||FileZilla Client|
|#7155||Minimize and Manual Transfer use same keyboard shortcut||new||Bug report||normal||FileZilla Client|
|#7269||Synchronized scrolling on Mac not working||new||Bug report||normal||FileZilla Client|
|#7278||Multiple dialogs simultaneously hangs client (OSX)||new||Bug report||normal||FileZilla Client|
|#7322||Wrong folder for preferences||new||Feature request||normal||FileZilla Client|
|#7326||Requesting new feature for the last opened bookmark||new||Feature request||normal||FileZilla Client|
|#7424||Drag & Drop on OSX 10.5 doen't work||new||Bug report||normal||FileZilla Client|
|#7874||Bypass proxy for all local sites||new||Feature request||normal||FileZilla Client|
|#7883||View/Edit is riddled with problems, please allow me to view but disable editing||new||Feature request||normal||FileZilla Client|
|#7908||Often locking folder navigation on Mac after awhile||new||Bug report||normal||FileZilla Client|
|#7943||Ability to handle urls from browser (Mac OS X)||new||Feature request||normal||FileZilla Client|
|#8034||Read permission denied Truncates local file||new||Bug report||normal||FileZilla Client|
|#8051||Files with identical names except for the letter case are not distinguished when editing||new||Bug report||normal||FileZilla Client|
|#8054||Click-dragging file transfers in a certain way quickly can make FileZilla unresponsive||new||Bug report||normal||FileZilla Client|
|#8271||Cannot move OSX client window in the normal fashion||new||Bug report||normal||FileZilla Client|
|#8290||PAPERCUT: 'Minimize to tray' checkbox behavior on OSX||new||Feature request||normal||FileZilla Client|
|#8291||PAPERCUT: A common OS X [Cmd+W] shortcut is not working.||new||Feature request||normal||FileZilla Client|
|#8292||Many interface languages in FileZilla cannot be used.||new||Bug report||normal||FileZilla Client|
|#8310||PAPERCUT: The tooltip says that right clicking on 'directory listing filter' icon should toggle the filters On/Off, but it only shows the filter configuration panel.||new||Bug report||normal||FileZilla Client|
|#8324||Slow and interrupted upload in FileZilla client 3.6 and 184.108.40.206 on Mac 10.8.2||new||Bug report||normal||FileZilla Client|
|#8328||PAPERCUT: 'Downloading update' download status bar and text on OSX are oversized.||new||Bug report||normal||FileZilla Client|
|#8391||Full screen feature for Mac OS||new||Feature request||normal||FileZilla Client|
|#8404||Favorites in Dock menu||new||Feature request||normal||FileZilla Client|
|#8427||PAPERCUT: Only the very top of the FileZilla title bar is draggable on OSX||new||Bug report||normal||FileZilla Client|
|#8461||Directory tree view is not refreshed after dragging folders.||new||Bug report||normal||FileZilla Client|
|#8484||Please change 'Selected file already being edited' box.||new||Feature request||normal||FileZilla Client|
|#8660||Better handling / overview site manager list under Mac||new||Feature request||normal||FileZilla Client|
|#8702||Improve Update Process||new||Feature request||normal||FileZilla Client|
|#8749||Lockup after downloading file while editing||new||Bug report||normal||FileZilla Client|
|#9088||Creation date appears in Last Modified column on FTP to OpenVMS||new||Bug report||normal||FileZilla Client|
|#9570||Apply to current queue - apply to current operation||new||Feature request||normal||FileZilla Client|
|#9583||Make an app bundle also when GTK is used on Mac||new||Feature request||normal||FileZilla Client|
|#9690||Numpad Enter not working as file upload||new||Bug report||normal||FileZilla Client|
|#9704||File associations and stop working properly after update to 220.127.116.11||new||Bug report||normal||FileZilla Client|
|#9918||Allow resizeable window in 'Check for updates' dialog||new||Feature request||normal||FileZilla Client|
|#10081||Enable Fullscreen Mode for OSX Mountain Lion||new||Feature request||normal||FileZilla Client|
|#10082||Add a new set of icons (for OSX)||new||Feature request||normal||FileZilla Client|
|#10285||Right/Command Click for List Of Sites||new||Bug report||normal||FileZilla Client|
|#10296||Problem resizing winfdow in multiscreen configuration||assigned||Bug report||normal||FileZilla Client|
|#10314||Keyboard Shortcut for Add files to queue||new||Feature request||normal||FileZilla Client|
|#10483||Site Manager default status||new||Feature request||normal||FileZilla Client|
|#10660||Press [Enter] to connect to site||new||Feature request||normal||FileZilla Client|
|#10737||“FileZilla.app” is damaged and can’t be opened.||reopened||Bug report||normal||FileZilla Client|
|#10757||OSX Filename Filters toggle key not working||new||Bug report||normal||FileZilla Client|
|#10791||Underscores on Mac OS X not recognized when typed to jump to another file or folder||new||Bug report||normal||FileZilla Client|
|#10804||On Mac, 'return' key should trigger colored button on windows||new||Bug report||normal||FileZilla Client|
|#10863||Could not read from socket: ECONNRESET||moreinfo||Bug report||normal||FileZilla Client|
|#10956||File selection disabled when renaming a file||new||Bug report||normal||FileZilla Client|
|#10992||Uploading Links/Aliases via DND on OSX does not dereference 3.10.2||new||Bug report||normal||FileZilla Client|
|#11025||Version 3.22.0 SFTP cannot connect to server||new||Bug report||normal||FileZilla Client|
|#11060||OSX Automatic update||new||Feature request||normal||FileZilla Client|
|#11075||Prevent gaining focus on os x||new||Bug report||normal||FileZilla Client|
|#11089||When uploading, uploads stop with 1 second left.||moreinfo||Bug report||normal||FileZilla Client|
|#11104||Permissions Change to 644 During SFTP Transfers||new||Bug report||normal||FileZilla Client|
|#11106||Toolbar icons/buttons vague and button status hard to determine||new||Feature request||normal||FileZilla Client|
|#11133||Pressing space bar while any entry of the Server list is focused automatically closes Site manager and logs i||new||Bug report||normal||FileZilla Client|
|#11142||Feature Request: Option to always create missing folder||new||Feature request||normal||FileZilla Client|
|#11159||Site Manager - Make a pane||new||Feature request||normal||FileZilla Client|
|#11182||More details, please !||new||Other||normal||FileZilla Client|
|#11191||Fix double clicking on filename (to agree with convention)||new||Feature request||normal||FileZilla Client|