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. Enterprise-level Box Admins can enable unencrypted FTP connections from the Security tab of their Enterprise Settings

 

Screen Shot 2018-06-05 at 1.56.30 PM.png

 

Note: The setting above is checked off by default for Business and Enterprise account types. You must be an enterprise level account to have the ability to uncheck this setting and disable your users from using unencrypted FTP. 

 

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 (SSO log in not supported)
  • 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.
  • TLSv1.1 or TLSv1.2 is required. TLSv1.0 is not supported as of June 25, 2018.

Filezilla example: See below for quick connecting:

 

Use Filezilla Site Manager to easily store/retrieve your Box FTP settings:

  • File > Site Manager: 
    Filezilla Site Manager.pngFilezilla > Site Manager
  • In the Filezilla Site Manager example above, leave the "Port" field blank as shown so it is handled automatically.
  • If "Unknown certificate" dialog appears, select the checkbox "Always trust certificate in future sessions"

 

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 that your firewall has these ports open. 
  • Error:  Connection timed out after 20 seconds of inactivity: Increase your timeout setting under Filezilla > Preferences > Connection > Timeout.  Setting this to 120 seconds can be helpful for folders containing large numbers of files.
  • 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, log in with your web browser and Box credentials (or External Password if using SSO login) to app.box.com.
  • 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. 

Please include a copy of your FTP client log if contacting Box Support.

 

For advanced help with FTP or command line usage, please see our FTP Troubleshooting article.
See the Migrate Content article for other methods to use. 

Version history
Revision #:
16 of 16
Last update:
‎07-12-2018 01:11 PM
Updated by:
 

Users online (206)