Editing FAQ

From FileZilla Wiki
Jump to navigationJump to search

Warning: You are not logged in. Your IP address will be publicly visible if you make any edits. If you log in or create an account, your edits will be attributed to your username, along with other benefits.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.

Latest revision Your text
Line 4: Line 4:
  
 
<ol>
 
<ol>
 
<li><b>How much does FileZilla cost?<br />Is FileZilla free?<br />Can FileZilla be used commercially?</b><br />
 
FileZilla is free open-source software distributed under the terms of the [http://filezilla.sourceforge.net/GPL.html GNU General Public License] free of charge.
 
<br />
 
Basically this means that everyone, including corporate entities, can use FileZilla, including but not limited to private, educational and commercial use.
 
</li>
 
 
<li><b>What do the version numbers of FileZilla mean?</b><br />
 
<li><b>What do the version numbers of FileZilla mean?</b><br />
 
The version numbers of FileZilla (client and server) are in the following format: n.n.n[c], where n is a number and c an alphabetical character.
 
The version numbers of FileZilla (client and server) are in the following format: n.n.n[c], where n is a number and c an alphabetical character.
 
The first number is the major version number followed by two minor version numbers. The character at the end is optional and indicates maintenance releases, which mostly fix bugs; the "a" or "b" suffix does NOT imply the instabilities conventionally associated with an "alpha" or "beta" quality release.
 
The first number is the major version number followed by two minor version numbers. The character at the end is optional and indicates maintenance releases, which mostly fix bugs; the "a" or "b" suffix does NOT imply the instabilities conventionally associated with an "alpha" or "beta" quality release.
  
<br />
+
<br>
<br />
+
<br>
 
Example: 2.2.4 would be the original version, the first maintenance would then get 2.2.4a as version, the next 2.2.4b and so on.
 
Example: 2.2.4 would be the original version, the first maintenance would then get 2.2.4a as version, the next 2.2.4b and so on.
<br />
+
<br>
<br />
+
<br>
</li>
 
 
 
<li>
 
<b>I have a question, where can I get help?</b><br />
 
Most importantly, don't rush. Think before you ask. What are you trying to do? What is happening instead? What should have happened?
 
You might find the following two guides of interest:<br />
 
[http://www.catb.org/~esr/faqs/smart-questions.html How To Ask Questions The Smart Way] by Eric S. Raymond<br />
 
[http://www.chiark.greenend.org.uk/~sgtatham/bugs.html How to Report Bugs Effectively] by Simon Tatham<br />
 
Please also have a look at the [[Limitations|known limitations of FileZilla]]
 
 
</li>
 
</li>
  
<li>
+
<li><b>What is "FileZilla 3" seen on the changelog page?</b><br />
<b>How to get in contact with with the FileZilla team?</b><br />
+
Version 3 is a major redesign of the code base that was started in early 2004 and is still unfinished.  You can safely ignore it unless you are a developer.  If you are looking for the real changelog for the 2.x binaries, click the "[http://filezilla-project.org/changelog.php?type=1 FileZilla]" and "[http://filezilla-project.org/changelog.php?type=2 FileZilla Server]" links under "Select Changelog".
There are several ways to establish [http://filezilla-project.org/contact.php contact] with the developers: the easiest way might be the use of our [http://forum.filezilla-project.org forum] or, if a direct conversation is needed, IRC - #filezilla at freenode (<i>chat.freenode.net</i> or see the [http://freenode.net/irc_servers.shtml list of servers]).
 
 
</li>
 
</li>
 
 
</ol>
 
</ol>
  
Line 41: Line 24:
 
<ol>
 
<ol>
 
<li><b>I can't list the contents of any directory on the server or I can't transfer any files</b><br />
 
<li><b>I can't list the contents of any directory on the server or I can't transfer any files</b><br />
<b>I get "Critical transfer errors"</b><br />
+
In most cases this problem is caused by personal firewalls or routers. You could try to switch "Enable passive mode" on the firewall page in the settings dialog of the client. In some cases you may need to DEACTIVATE passive mode. If the passive mode is not working while enabled, which is enabled by default, deactvating this may solve your problems.
<b>I can't connect to my server</b><br />
+
</li>
Most likely incorrect configuration of either FileZilla, your firewall, your router or a combination of it. Please read the [[Network Configuration]] guide.
+
 
 +
<li><b>Why can't I save my passwords in the Site Manager?</b><br />
 +
FileZilla can be installed in a special secure mode. In this mode, FileZilla does not remember any password. This is especially useful if you share your PC or if it's a public machine.
 +
To disable secure mode, just reinstall FileZilla and choose <b>not</b> to enable secure mode during setup.
 
</li>
 
</li>
  
 
<li><b>What are the command line options supported by FileZilla?</b><br />
 
<li><b>What are the command line options supported by FileZilla?</b><br />
 
+
You can append ftp server addresses to the command line of FileZilla. Valid addresses would be from the form [([s]ftp|ftps)://][user[:pass]@]host[:port][/path]
See [[Command-line arguments (Client)]]</li>
+
Example: ftp://root:secretpw@filezilla.sourceforge.net/htdocs/
 
+
You can also use the "-s siteName" switch to connect to a site in your Site Manager at startup.
<li><b>Where does FileZilla store all its sites and settings?</b><br />
+
Some more less useful command line options can be found here: [[Command-line_arguments|Command-line arguments]]
The location of FileZilla's settings directory depends on your operating system. On most systems, sites and settings are stored in the ''~/.config/filezilla'' directory. The odd exception is Windows, where the settings are stored in the ''%APPDATA%/FileZilla'' directory.
 
 
</li>
 
</li>
  
Line 57: Line 42:
 
This could happen if for some reason your FileZilla installation or the settings get corrupted.  
 
This could happen if for some reason your FileZilla installation or the settings get corrupted.  
 
First try to reinstall FileZilla, this won't change your settings.
 
First try to reinstall FileZilla, this won't change your settings.
If that does not help, delete FileZilla's settings directory (see above). Notice that all your settings and sites are lost if you do this without taking a backup.  
+
If that didn't work, try to delete the filezilla.xml and the registry keys under HKEY_CURRENT_USER\Software\FileZilla and HKEY_LOCAL_MACHINE\Software\FileZilla.
 +
Notice that all your settings and sites are lost if you do this without taking a backup.  
 
</li>
 
</li>
  
<li><b>I can't start FileZilla under Windows 95, 98, ME, NT4, 2000 or XP, it terminates with a runtime error.</b><br />
+
<li><b>How can I export and import my settings and sites?</b><br />
The most recent versions of FileZilla no longer support Windows 9x/ME/NT4/2000/XP. Please consider upgrading your OS to Windows Vista or higher, especially since the older Windows versions are no longer supported by Microsoft. Using older versions of FileZilla is not recommended due to known security vulnerabilities.
+
If you've chosen to use the .xml file instead of the registry, all your settings and sites are located in the filezilla.xml file which is in the same directory as FileZilla.
 +
You could just backup that file to export and copy it back to the FileZilla folder to import(overwriting all previous settings and sites).
 +
If you've chosen to use the registry or you would like to export/import only settings or sites, you could go "Edit -> Export settings" to export your settings, and then in Site Manager go "File -> Export" to export your sites. Notice there's also import functions here so use them to import the settings back.
 
</li>
 
</li>
  
<li><b>I want to help, how can I translate the FileZilla client?</b><br />
+
<li><b>I can't start FileZilla under Windows 95, 98 or ME, it terminates with a runtime error.</b><br />
Please see http://filezilla-project.org/translations.php for details.
+
The most recent versions of FileZilla no longer support Windows 9x/ME. Please consider upgrading your OS to Windows 2000 or higher, especially since the older Windows versions are no longer supported by Microsoft. Using older versions of FileZilla is not recommended due to known security vulnerabilities.
 
</li>
 
</li>
  
<li><b>FileZilla does not display or transfer files containing non-English characters</b><br />
+
<li><b>I want to help, how can I translate the FileZilla client?</b><br />
Please see the [[Character Set]] entry.
+
No new translations for FileZilla 2 are accepted. However, you can already translate huge parts of the upcoming FileZilla 3. See http://filezilla-project.org/translations.php for details.
 
</li>
 
</li>
 
 
</ol>
 
</ol>
  
Line 78: Line 65:
 
<ol>
 
<ol>
 
<li><b>I've just installed the server and after starting the interface, it asks for a server address.</b><br />
 
<li><b>I've just installed the server and after starting the interface, it asks for a server address.</b><br />
The administration interface can be used to configure local or remote servers. Most likely you want to configure your local server. In this case enter 127.0.0.1 as server address. For the server port, you have to enter the same port number you did specify during installation for the admin port. (default: 14148). If you set a password, enter it. If you want the administration interface to remember it, select the appropriate checkbox.</li>
+
Despite administrating the server on the local machine, the interface can also be used to administrate remote servers. But you will most likely want to administrate your local server. In this case enter 127.0.0.1 as server address. For the server port, you have to enter the same port number you did specify during installation for the admin port. (default: 14147)
 +
</li>
  
 
<li><b>I'm behind a <u>firewall</u> and nobody can connect to my server or transfer files / directory listings</b><br />
 
<li><b>I'm behind a <u>firewall</u> and nobody can connect to my server or transfer files / directory listings</b><br />
You have to configure your firewall to allow incoming connections on the ftp/ftps port (default: 21/990), as well as allowing outgoing connections from the server. In FTP Active Mode, FileZilla Server tries to use a port whose value is equal to the ftp port for outgoing connections minus one. If that fails it tries to use a port number that is equal to the ftp port plus one, then it requests a port from the operating system. For that reason it might be easier to allow all outgoing connections from the server. Further you have to allow a port range for incoming connections for passive mode transfers. You can specify a port range on the "Passive mode" page in the settings dialog. In most cases, a range like 5000-5100 is sufficient. With certain firewalls, FileZilla Server might not be able to determine the external IP address. In this case you have to enter manually the IP address (or the host name) on the “Passive mode” page in the settings dialog.
+
You have to configure your firewall to allow incoming connections on the ftp port (default: 21), as well as allowing outgoing connections from the server. In FTP ''Active Mode'', FileZilla Server tries to use a port one less than the ftp port for outgoing connections. If that fails it tries to use a port one larger than the ftp port and after that it requests a port from windows. It may be best to allow all outgoing connections from the server.
 +
Further you have to allow a port range for incoming connections for passive mode transfers. You can specify this port range on the "passive mode settings" page in the settings dialog in the server interface. In most cases, a range like 5000-5100 is sufficient.
 +
With certain firewalls, it may be possible that FileZilla can't determine the external IP address. In this case you have to enter the IP address (or your host name) on the passive mode page in the settings dialog. In case you've a dynamic IP (most dial-up users), you can also choose to retrieve the ip address from a website.
 
</li>
 
</li>
  
 
<li><b>I'm behind a <u>router</u> and nobody can connect to my server or transfer files / directory listings</b><br />
 
<li><b>I'm behind a <u>router</u> and nobody can connect to my server or transfer files / directory listings</b><br />
You have to configure your router to forward the ftp/ftps port (default: 21/990) to the server machine. Further you have to forward a port range for passive mode transfers. You can specify that port range on the "Passive mode" page in the settings dialog. In most cases, a range like 5000-5100 is sufficient. Most likely, FileZilla Server might not be able to determine the external IP address if it is behind a router. In this case you have to enter manually the IP address (or your host name) on the Passive mode page in the settings dialog. </li>
+
You have to configure your router to forward the ftp port (default: 21) to the server machine.
 +
Further you have to forward a port range for passive mode transfers. You can specify this port range on the "passive mode settings" page in the settings dialog in the server interface. In most cases, a range like 5000-5100 is sufficient.
 +
Most likely, FileZilla can't determine the external IP address if behind a router. In this case you have to enter the IP address (or your host name) on the passive mode page in the settings dialog. In case you've a dynamic IP (most dial-up users), you can also choose to retrieve the ip address from a website.
 +
</li>
  
 
<li><b>I'm behind a <u>router and a firewall</u> and nobody can connect to my server or transfer files / directory listings</b><br />
 
<li><b>I'm behind a <u>router and a firewall</u> and nobody can connect to my server or transfer files / directory listings</b><br />
Line 92: Line 85:
  
 
<li><b>How can I enable anonymous logins?</b><br />
 
<li><b>How can I enable anonymous logins?</b><br />
Just create an account with the name <i>anonymous</i> or any other name of your choice and select from the Credentials top-down menu the "Do not require a password to log in" option.
+
Just create an account with the name <i>anonymous</i> and make sure the password box isn't checked on that account.
 
</li>
 
</li>
  
 
<li><b>How can I test that my server can be reached from the internet?</b><br />
 
<li><b>How can I test that my server can be reached from the internet?</b><br />
The easiest way to test the connection to your server is from an external machine. You can test the accessibility of your server using the free service from http://ftptest.net/. Note that connecting from inside the local network or localhost might not work as firewalls and/or routers could forward ports only for requests coming from outside the internal network.
+
It's not possible to check the accessibility of the server by connecting from inside the local network (or even localhost) by entering the external IP in a client. Reason is that most firewalls and/or routers only forward ports for requests coming from outside the internal network.
 +
So you would have to connect to your server from an external machine.
 +
You can test the accessibility of your server using the free service from http://www.web2ftp.com
 +
Note: as of 10/16/2006, web2ftp.com is deactivated because they were having trouble with malicious users. You can use the service provided by Gene6 FTP at http://www.g6ftpserver.com/en/ftptest . {http://surftp.com/index.php SurFTP] is a second viable alternative.
 
</li>
 
</li>
  
<li><b>How do mount points work? How can I share multiple mount points?</b><br />
+
<li><b>How do aliases work?</b><br />
 
+
Let's assume you have two shared folders: <i>c:\ftproot</i> is your homedir and <i>d:\myfiles</i> is the second one.
Let's say you want to make your picture collection in D:\mypictures available as /pictures for a specific User or Group. Create the user/group and in the right panel click on the Add button and set the Virtual path to / and the Native path to D:\mypictures. Now the server will display the virtual directory pictures right in the root directory for that user or group and its content will be that of D:\mypictures.
+
In order to display an alias to <i>d:\myfiles</i> in your homedir, add <i>/myalias</i> as alias in the second column to the right of <i>d:\myfiles</i>. A new folder with the name <i>myalias</i> will appear in your homedir with the contents of <i>d:\myfiles</i>
If you want to share multiple mount points just add more of them.
 
 
 
<li><b>The Administration interface says that the virtual and/or native path is invalid, or that it must be absolute or not be empty, how do I fix that?</b><br />
 
 
 
Mount point paths, both the virtual and native ones, must be entered in a specific format. To learn more about that format, The native path is a local file path, the virtual path is the path that the FTP users will see and it is mapped to the native path by FileZilla Server. To add a mount point click on the Add button and enter a virtual path (eg. \) and a native path (eg, C:\ftproot\sample).
 
 
 
 
 
 
 
 
</li>
 
</li>
  
 
<li><b>How can I share network drives?</b><br />
 
<li><b>How can I share network drives?</b><br />
 
Generally sharing network drives is not recommended, as all data has to be transferred twice. Just install FileZilla Server on the other machine instead.
 
Generally sharing network drives is not recommended, as all data has to be transferred twice. Just install FileZilla Server on the other machine instead.
If you still want to share a network drives with FileZilla Server, make sure the account FileZilla Server runs under has access to the network drive. By default, FileZilla Server runs using the SYSTEM account. You can change the account FileZilla Server uses on the service page in the management console of Windows: Start -> Settings -> Control Panel -> Administrative Tools -> Services -> FileZilla Server FTP server -> Log On.
+
If you still want to share a network drives with FileZilla Server, make sure the account FileZilla Server runs under has access to the network drive. You can change the account FileZilla Server uses on the service page in the management console of Windows.
 
+
However, even then sharing drives might not work since Windows networking has some bugs.
However, even then sharing mapped network drives might not work since Windows networking has some bugs.
 
 
</li>
 
</li>
  
<li>'''Is it safe for all user and groups settings to upgrade from older Filezilla server?'''<br/>
+
<li>'''Command line options for FileZilla Server'''<br/>
Upgrading to the newest version is always recommended, configurations are automatically migrated.</li>
+
-start -stop -install -uninstall -compat -reload-config
 
+
-compat is used for Win9x compatibility, so FZS does not start as service and has to be the first switch.</li>
<li>'''I have forgotten my password for connection to my server via administration interface. How can I reset it?'''<br/>
+
<pre>
The password is stored in the <filezilla><admin><password> section of the server settings file. You should completely remove the <password> section and restart the server. After that you can connect to the server without password.
+
"FileZilla server.exe" -reload-config
By default the settings file is stored in %appdata%\filezilla-server folder of the user who started the server. The windows service run as System user by default. The path of System user's appdata is %windir%\system32\config\systemprofile\AppData\Local\.
+
</pre>
Also you can find out the settings file path in logs. Just open <installation folder>\Logs\filezilla-server.log and find a line with "Settings written to " string.
 
</li>
 
 
</ol>
 
</ol>

Please note that all contributions to FileZilla Wiki are considered to be released under the GNU Free Documentation License 1.2 (see FileZilla Wiki:Copyrights for details). If you do not want your writing to be edited mercilessly and redistributed at will, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource. Do not submit copyrighted work without permission!

Cancel Editing help (opens in new window)