Skip to main content
All CollectionsAssembla BasicsTools
Deploy and Update Websites Using FTP
Deploy and Update Websites Using FTP
Toshi Dávila avatar
Written by Toshi Dávila
Updated over a month ago

The FTP tool pushes code commits to an FTP or SFTP server. You can use it to deploy and update web sites. 

Adding the FTP tool

To add the FTP tool

  1. Go to Space Settings > Tools.

  2. Scroll down to the Build and Deploy section and you'll see the FTP option. 

  3. Click Add to configure.

Configuring the FTP tool

To configure your FTP server

  1. Go to Space Settings > Tools.

  2. Click Settings next to the FTP option.

  3. Complete the following fields:

    1. FTP Server Name. Type any name that you want to give to identify this configuration internally. This field is used only as a recognizable label for your convenience.

    2. FTP Server Address. The Full Hostname of your FTP server, without the folder path. For example, ftp.example.com.

    3. Remote Path. The folder path of the remote folder on your FTP server to which you want to deploy.

    4. Login. The username of the FTP account used by the FTP tool to write to your remote folder.

    5. Password. The password of the FTP account used by the FTP tool to write to your remote folder.

    6. Repository. The folder in your Assembla repository where this is deployed. If you want to deploy from the root folder of your Assembla repository, you can leave this field blank.

  4. Click Add server when done.

Reviewing FAQs

What are some tips to using this tool?

  • The Remote path folder must exist and be empty when you deploy for the first time.

  • The user account in the Login field must exist on the server and must have write permissions.

  • Do not modify the content in the remote folder manually. The FTP tool must manage the content.

Can I change the Remote Path after the first deploy?

If you change the remote path after deployment, you should manually copy the content from the remote folder listed as the previous Remote Path into the remote folder now listed as the Remote Path, or the deploy will fail.

How can I fix the deploy if I changed the content of the remote folder by hand?

You should delete the FTP Tool from the Space Settings > Tools page, then add it and configure it again. You need to deploy to a new empty folder, or delete the existing contents on the remote folder before doing a deploy with the new FTP tool.

Is there a problem if I configure two servers with the same Server Address and Remote Path?

At this time, we do not have a check in place to prevent duplicate server configs, but trying to use duplicate servers breaks the deploy of both servers.

Is there a limit of servers?

Yes, you can have up to 50 FTP servers per space.

What if I get this error: 'FTP deploy fails with number of max retries exceeded'?

Please try the following: 

  1. Make sure your FTP credentials are correct.

  2. Try setting 'Active' and 'Passive' modes, and then run a test deploy to see if it works.

  3. Decrease number of concurrent connections to 5 or 3.

  4. Set up path from absolute (/trunk) to a folder containing small amount of files (like /trunk/folder).


If you have any questions or need assistance. Please always feel free to email us at support@assembla.com. We will be happy to assist.

Did this answer your question?