FTP Status and Error Codes

During FTP sessions, servers send and receive various numbered codes to/from FTP clients. Some codes represent errors; most others simply communicate the status of the connection. Below are brief explanations for the most common status and error codes.

When determining a course of action, review the entire log; some codes are informational only, others indicate that you have entered the wrong information, and others indicate what information you need to provide before continuing.

If a remote server is actively refusing your attempt to connect to it, try the following to correct the error:

  1. Verify that the destination server name, IP address, and port numbers are correct.

  2. Try again later. The remote server may be temporarily or permanently inaccessible

  3. Verify that you have chosen the right protocol (SSH2, SSL, FTP, etc.) and have configured all required options for that protocol.

  4. Try using only one connection thread when connecting to this particular server. The remote server may be refusing multiple connections from the same client.

  5. Try pinging the IP address of the server.

  6. If you are using a router, verify the router is up and running. (Check it by pinging it and then ping an address outside of the router.)

  7. Use tracert to verify all routers along the connection path are operational.

  8. Verify that your subnet mask is configured properly.

  9. Verify that your local software or hardware firewall is not blocking outbound connections originating from your FTP client.

  10. Disable your anti-virus software to determine if it is blocking the connection.

Code

Description

Possible Solutions:

100 Series

The requested action was initiated; expect another reply before proceeding with a new command.

110

Restart marker reply.

(Informational)

120

Service ready in nn minutes.

(Informational)

125

Data Connection already open, transfer starting.

(Informational)

150

File status okay, about to open data connection. FTP uses two ports: 21 for sending commands, and 20 for sending data. A status code of 150 indicates that the server is about to open a new connection on port 20 to send some data.

(Informational)

200 Series

The requested action has been successfully completed.

200

Command okay.

(Informational)

202

Command not implemented, superfluous at this site.

(Informational)

211

System status or system help reply.

(Informational)

212

Directory status.

(Informational)

213

File status.

(Informational)

214

Help message.

(Informational)

215

NAME system type. (Where NAME is an official system name from the list in the Assigned Numbers document.)

(Informational)

220

Service ready for new user.

(Informational)

221

Service closing control connection. Logged out if appropriate.

(Informational)

225

Data connection open; no transfer in progress.

(Informational)

226

Closing data connection. Requested file action successful (for example; file transfer or file abort). The command opens a data connection on port 20 to perform an action, such as transferring a file. This action successfully completes, and the data connection is closed.

(Informational)

227

Entering Passive Mode.

(Informational)

230

User logged in, proceed. This status code appears after the client sends the correct password. It indicates that the user has successfully logged on.

(Informational)

250

Requested file action okay, completed.

(Informational)

257

"PATHNAME" created.

 

(Informational)

300 Series

The command has been accepted, but the requested action is on hold, pending receipt of further information.

331

User name okay, need password.

You see this status code after the client sends a user name, regardless of whether the user name that is provided is a valid account on the system.

332

Need account for login.

Provide login credentials

350

Requested file action pending further information.

(Informational)

400 Series

The command was not accepted and the requested action did not take place, but the error condition is temporary and the action may be requested again.

421

Error 421 Service not available, closing control connection.
Error 421 User limit reached
Error 421 You are not authorized to make the connection
Error 421 Max connections reached
Error 421 Max connections exceeded

Try logging in later.

425

Cannot open data connection.

Change from PASV to PORT mode, check your firewall settings, or try to connect via HTTP.

426

Connection closed; transfer aborted. The command opens a data connection to perform an action, but that action is canceled, and the data connection is closed.

Try logging back in. Contact your hosting provider to determine if you need to increase your hosting account. Try disabling the firewall on your PC to see if that solves the problem. If not, contact your hosting provider or ISP.

450

Requested file action not taken. File unavailable (e.g., file busy).

Try again later.

451

Requested action aborted; local error in processing.

Ensure command and parameters were typed correctly.

452

Requested action not taken. Insufficient storage space in system.

Ask FTP administrator to increase allotted storage space, or archive/delete remote files.

500 Series

The command was not accepted and the requested action did not take place.

500

Syntax error, command unrecognized, command line too long.

Try switching to passive mode.

501

Syntax error in parameters or arguments.

Verify your input; i.e., make sure there are no erroneous characters, spaces, etc.

502

Command not implemented.

The server does not support this command.

503

Bad sequence of commands.

Verify command sequence.

504

Command not implemented for that parameter.

Ensure entered parameters are correct.

530

User not logged in. 

Ensure that you typed the correct user name and password combination. Some servers use this code instead of 421 when the user limit is reached

532

Need account for storing files.

Logged in user does not have permission to store files on remote server.

550

Requested action not taken. File unavailable, not found, not accessible

Verify that you are attempting to connect to the correct server/location. The administrator of the remote server must provide you with permission to connect via FTP.

552

Requested file action aborted. Exceeded storage allocation. 

More disk space is needed. Archive files on the remote server that you no longer need.

553

Requested action not taken. File name not allowed.

Change the file name or delete spaces/special characters in the file name.

10,000 series

Common Winsock Error Codes (complete list of Winsock error codes)

10054

Connection reset by peer. The connection was forcibly closed by the remote host.

(Informational)

10060

Cannot connect to remote server (Generally a time-out error).

Try switching from PASV to PORT mode, or try increasing the time-out value.

10061

Cannot connect to remote server. The connection is actively refused by the server.

Try switching the connection port.

10066

Directory not empty. The server will not delete this directory while there are files/folders in it.

If you want to remove the directory, first archive or delete the files in it.

10068

Too many users, server is full.

Try logging in at another time.