Troubleshooting FTP

Common FTP problems
FTP with firewalls
FTP from behind a proxy server
Common FTP problems

When you upload files to your web space, you may encounter problems that have a simple solution.

I've uploaded my website but it doesn't show in my browser

Solution: Upload your files to htdocs.

Any files that you want to make publicly available must be uploaded to the htdocs folder in your web space. It's easy to mistakenly upload your files to your web space's root folder.

Log into your FTP account and make sure that your files are uploaded to htdocs.

You should also check that the web page uses one of the default web page file names:

index.wml
default.wml
index.htm
index.html
default.html
index.asp
default.htm
default.asp
index.shtml
index.stm
default.shtml
index.shtml
index.ihtml
default.ihtml
_index.html

I can't connect to my FTP account

Solution 1: Firewalls can often prevent you from connecting to your FTP account. Ensure that any firewall software you have is configured to allow your FTP software to communicate with the internet and that your FTP software is connecting in passive mode.

Solution 2: Ensure that passive FTP and FTP folder view are enabled, if you are using Internet Explorer for FTP.

I've uploaded a file but it shows as 0 bytes on the server

Solution: This problem is often caused by firewalls that block the file transfer itself but not the opening or closing of the transfer. This causes the FTP server to receive a file containing no data.

FTP with firewalls

Some firewalls may be configured to prevent your FTP software from connecting to your web space. You can usually solve this with a quick change to either your firewall or FTP software's settings.

Follow the steps below to fix the most common issues that may prevent your FTP software from connecting to your web space. If a step doesn't help, move to the next.

Step 1: Is your FTP software set to passive mode?

FTP has two different modes - active and passive. In active mode, the FTP server (i.e. your web space) attempts to connect to your computer, which may be treated as a security risk by your firewall.

In passive mode, your FTP software sets up the connection with your web space. As the connection originates with your computer, most firewalls will allow it.

Ensuring your FTP software is set to passive mode is quick, easy and likely to work for most people.

Step 2: Is your FTP software blocked by a firewall application on your computer?

If you run a software firewall on your computer - such as ZoneAlarm, Sygate Personal Firewall or Norton Firewall, amongst many others - it may be configured to block your FTP software.

Open your firewall's configuration utility and ensure that it allows traffic from your FTP software.

Quick tip: You may need to have your FTP software running when you open the firewall's configuration utility.

Step 3: Is your FTP software blocked by a broadband router?

If you have a broadband router that has a built-in firewall, it may block FTP traffic. Follow the instructions in your router's manual to open ports 21 and 20.

Step 4: Is your computer on a corporate network?

Many corporate networks block all non-web or email traffic, including FTP. Contact your system administrator to request that FTP traffic be allowed from your computer.

FTP from behind a proxy server

If your computer is behind an FTP proxy server, you may still be able to upload files to your web space using FTP.

Simply set your operating system to route FTP requests through the proxy server.

FTP proxy settings in Windows XP

Step 1: Click the Windows start button in the bottom-left of the screen.
Step 2: Click Control Panel.
Step 3: Click Network and Internet Connections.
Step 4: Click Internet Options.
Step 5: The Internet Properties window will open. Click the Advanced tab.
Step 6: Click the LAN Settings button towards the bottom of the window.
Step 7: In the Local Area Network (LAN) Settings window, select the Use a proxy server for your LAN check-box.
Step 8: Click the Advanced button.
Step 9: In the Proxy Settings window, Use the FTP text-boxes to enter the proxy address and port given to you by your provider for FTP connections.

Important: You must also specify proxy servers for any other services you wish to use. Ask your internet connection provider for details.

Step 10: Click the OK button.
Step 11: Click the OK button on the Local Area Network (LAN) Settings window.
Step 12: Click OK on the Internet Properties window.

Your PC is now configured to use the FTP proxy provided by your ISP.