FAQ: Difference between revisions

From FileZilla Wiki
Jump to navigationJump to search
m (Remove spam)
m (Reverted edits by Luem (talk) to last revision by CodeSquid)
Tag: Rollback
 
(80 intermediate revisions by 32 users not shown)
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><b>What is "FileZilla 3" seen on the changelog page?</b><br />
<li>
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".
<b>How to get in contact with with the FileZilla team?</b><br />
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 24: Line 41:
<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 />
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.
<b>I get "Critical transfer errors"</b><br />
<b>I can't connect to my server</b><br />
Most likely incorrect configuration of either FileZilla, your firewall, your router or a combination of it. Please read the [[Network Configuration]] guide.
</li>
</li>


<li><b>Why can't I save my passwords in the Site Manager?</b><br />
<li><b>What are the command line options supported by FileZilla?</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.
See [[Command-line arguments (Client)]]</li>
</li>


<li><b>What are the command line options supported by FileZilla?</b><br />
<li><b>Where does FileZilla store all its sites and settings?</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]
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.
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.
Some more less useful command line options can be found here: [[Command-line_arguments|Command-line arguments]]
</li>
</li>


Line 42: Line 57:
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 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.
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.  
Notice that all your settings and sites are lost if you do this without taking a backup.  
</li>
</li>


<li><b>How can i export and import my settings and sites?</b><br />
<li><b>I can't start FileZilla under Windows 95, 98, ME, NT4, 2000 or XP, it terminates with a runtime error.</b><br />
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.
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.
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 can't start FileZilla under Windows 95 - it complains about missing WS2_32.DLL!</b><br />
<li><b>I want to help, how can I translate the FileZilla client?</b><br />
In order to run FileZilla in an Windows 95 environment, FileZilla requires the WinSock2 files. Please download them from the Microsoft website:
Please see http://filezilla-project.org/translations.php for details.
http://www.microsoft.com/windows95/downloads/contents/wuadmintools/s_wunetworkingtools/w95sockets2/default.asp.
This only applies to older version of FileZilla, as newer versions don't run under Windows 95 anymore. Consider upgrading your OS to Windows NT 4.0 or higher (like Windows 2000 or Windows XP).  
</li>
</li>


<li><b>I want to help, how can I translate the FileZilla client?</b><br />
<li><b>FileZilla does not display or transfer files containing non-English characters</b><br />
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.
Please see the [[Character Set]] entry.
</li>
</li>
</ol>
</ol>


Line 67: Line 78:
<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 />
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)
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>
</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 port (default: 21), as well as allowing outgoing connections from the server. 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.
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.
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 determinate 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 port (default: 21) to the server machine.
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>
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 determinate 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><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 />
Just follow both steps 2 and 3 in this case.
</li>
</li>


<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> and make sure the password box isn't checked on that account.
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.
</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 />
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.
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.
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.
</li>
</li>


<li><b>How do aliases work?</b><br />
<li><b>How do mount points work? How can I share multiple mount points?</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.
 
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>
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.
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. You can change the account FileZilla Server uses on the service page in the management console of Windows.
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.
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>'''Is it safe for all user and groups settings to upgrade from older Filezilla server?'''<br/>
Upgrading to the newest version is always recommended, configurations are automatically migrated.</li>
 
<li>'''I have forgotten my password for connection to my server via administration interface. How can I reset it?'''<br/>
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.
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\.
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>
</li>
</ol>
</ol>

Latest revision as of 16:02, 17 October 2024

This is a list of frequently asked questions and corresponding answers. Please read this topic carefully before asking any questions.

General FAQ[edit]

  1. How much does FileZilla cost?
    Is FileZilla free?
    Can FileZilla be used commercially?

    FileZilla is free open-source software distributed under the terms of the GNU General Public License free of charge.
    Basically this means that everyone, including corporate entities, can use FileZilla, including but not limited to private, educational and commercial use.
  2. What do the version numbers of FileZilla mean?
    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.

    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.

  3. I have a question, where can I get help?
    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:
    How To Ask Questions The Smart Way by Eric S. Raymond
    How to Report Bugs Effectively by Simon Tatham
    Please also have a look at the known limitations of FileZilla
  4. How to get in contact with with the FileZilla team?
    There are several ways to establish contact with the developers: the easiest way might be the use of our forum or, if a direct conversation is needed, IRC - #filezilla at freenode (chat.freenode.net or see the list of servers).

FileZilla Client FAQ[edit]

  1. I can't list the contents of any directory on the server or I can't transfer any files
    I get "Critical transfer errors"
    I can't connect to my server
    Most likely incorrect configuration of either FileZilla, your firewall, your router or a combination of it. Please read the Network Configuration guide.
  2. What are the command line options supported by FileZilla?
    See Command-line arguments (Client)
  3. Where does FileZilla store all its sites and settings?
    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.
  4. Why won't FileZilla start anymore?
    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. 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.
  5. I can't start FileZilla under Windows 95, 98, ME, NT4, 2000 or XP, it terminates with a runtime error.
    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.
  6. I want to help, how can I translate the FileZilla client?
    Please see http://filezilla-project.org/translations.php for details.
  7. FileZilla does not display or transfer files containing non-English characters
    Please see the Character Set entry.

FileZilla Server FAQ[edit]

  1. I've just installed the server and after starting the interface, it asks for a server address.
    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.
  2. I'm behind a firewall and nobody can connect to my server or transfer files / directory listings
    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.
  3. I'm behind a router and nobody can connect to my server or transfer files / directory listings
    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.
  4. I'm behind a router and a firewall and nobody can connect to my server or transfer files / directory listings
    Just follow both steps 2 and 3 in this case.
  5. How can I enable anonymous logins?
    Just create an account with the name anonymous 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.
  6. How can I test that my server can be reached from the internet?
    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.
  7. How do mount points work? How can I share multiple mount points?
    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. If you want to share multiple mount points just add more of them.
  8. 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?
    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).
  9. How can I share network drives?
    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. However, even then sharing mapped network drives might not work since Windows networking has some bugs.
  10. Is it safe for all user and groups settings to upgrade from older Filezilla server?
    Upgrading to the newest version is always recommended, configurations are automatically migrated.
  11. I have forgotten my password for connection to my server via administration interface. How can I reset it?
    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. 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\. 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.