Using Box with FTP or FTPS

FTP is available to Business and Enterprise accounts for bulk migration of data. It is not available for Personal accounts (Free or Pro). This tool is designed to be used for initial bulk uploading and occasional bulk downloading of files from your account -- we do not recommend using FTP as your primary access method.

 

Note: Box supports Passive FTP. Active FTP is not supported. By default, only encrypted FTPS connections will be accepted by Box. Admins can enable unencrypted FTP connections from the Security tab of their Enterprise Settings

 

To connect to Box's FTP server you will need an FTP client of your choosing.  Please read how to Preserve Original Created/Modified Times.

 

To access Box's FTP server, please use the following:

  • Server: ftp.box.com
  • Username: Your Box account email address
  • Password: Your Box account password
  • Port: 990 for implicit encrypted connection (FTPS), 21 for standard, unencrypted connection (FTP) or explicit encrypted connection (FTPES). Transfers may be slower when using encryption due to additional processing.
  • Please note that we support Passive FTP, but not Active.

 

See the example image below for connecting with Filezilla:

 

Notes and Troubleshooting:

  • To access Box's FTP server, it is required to have Box FTP Server set to available in your Admin Console > Business/Enterprise Settings > Apps tab. This option should be set to available by default. If Box FTP Server is disabled, you will receive an Authentication Failed message when you attempt to log in from the FTP client.
  • FTP as a transfer protocol does not support Single Sign-On. If SSO is enabled for your account, you will need to create a Box-specific password to supplement your SSO login. You can do so by logging in to your Box account from a browser and going to your Account Settings. On the Account tab, you will find the section Create External Password.
  • The FTP protocol uses separate “channels” for authentication and data. Make sure all required ports are whitelisted. 
    • Box supports FTP (port 21), FTPS implicit (port 990), and FTPES explicit (port 21), over passive FTP. Box does not support active FTP or SFTP.
    • For the data channel, ports 10,000 - 29,999 are used. Check your firewall has these ports open. 
  • Resuming an upload/download: The commands, REST (restart) and APPE (append) are not supported. This means that we do not support resumable uploads/downloads on Box for FTP. Any failed upload or download needs to be retried. FTP client log will show: 551 Box: Partial-file uploads are not supported.
  • 530 Box: CAPTCHA is required. If you see this error, you have triggered Captcha on your account. To clear the Captcha, login with your web browser and Box credentials (or External Password if using SSO login) to app.box.com.
  • If you are a Box Enterprise administrator and would like to limit your managed users to only use FTPS - rather than FTP - please contact your Customer Success Manager.
  • Error on output file. If you see this error, you may have folder names with trailing space characters. These are not allowed. Please rename any folders to remove the extra space.
  • Request rate limit exceeded, please try again later. Reduce your number of simultaneous connections from your FTP client. 

For advanced help with FTP or command line usage, please see our FTP Troubleshooting article.

Version history
Revision #:
11 of 11
Last update:
‎02-13-2018 04:50 PM
Updated by: