Deployment over FTP


This is a grunttask for code deployment over the ftpprotocol.

These days gitis not only our goto code management tool but in many cases our deployment tool as well. But there are many cases where gitis not really fit for deployment:

  • we deploy to servers with only ftpaccess
  • the production code is a result of a build process producing files that we do not necessarily track with git

This is why a grunttask like this would be very useful.

For simplicity purposes this task avoids deleting any files and it is not trying to do any size or time stamp comparison. It simply transfers all the files (and folder structure) from your dev / build location to a location on your server.

Getting Started

This plugin requires Grunt ~0.4.0

If you haven't used Gruntbefore, be sure to check out the Getting Startedguide, as it explains how to create a Gruntfileas well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

npm install grunt-ftp-deploy --save-dev

and load the task:



To use this task you will need to include the following configuration in your gruntfile:

'ftp-deploy': {
  build: {
    auth: {
      host: '',
      port: 21,
      authKey: 'key1'
    src: 'path/to/source/folder',
    dest: '/path/to/destination/folder',
    exclusions: ['path/to/source/folder/**/.DS_Store', 'path/to/source/folder/**/Thumbs.db', 'path/to/dist/tmp']

Please note that when defining paths for sources, destinations, exclusions e.t.c they need to be defined having the root of the project as a reference point.

The parameters in our configuration are:

  • host- the name or the IP address of the server we are deploying to
  • port- the port that the ftpservice is running on
  • authPath- an optional path to a file with credentials that defaults to .ftppassin the project folder if not provided
  • authKey- a key for looking up credentials saved in a file (see next section). If no value is defined, the hostparameter will be used
  • src- the source location, the local folder that we are transferring to the server
  • dest- the destination location, the folder on the server we are deploying to
  • exclusions- an optional parameter allowing us to exclude files and folders by utilizing grunt's support for minimatch. The matchBaseminimatch option is enabled, so .git*would match the path /foo/bar/.gitignore.
  • forceVerbose- if set to trueforces the output verbosity.

Authentication parameters

Usernames and passwords can be stored in an optional JSON file (.ftppassin the project folder or optionaly defined inauthPath). The credentials file should have the following format:

  "key1": {
    "username": "username1",
    "password": "password1"
  "key2": {
    "username": "username2",
    "password": "password2"

This way we can save as many username / password combinations as we want and look them up by the authKeyvalue defined in the gruntconfig file where the rest of the target parameters are defined.

The task prompts for credentials that are not found in the credentials file and it prompts for all credentials if a credentials file does not exist.

IMPORTANT: make sure that the credentials file uses double quotes (which is the proper JSONsyntax) instead of single quotes for the names of the keys and the string values.


This task is built by taking advantage of the great work of Sergi Mansilla and his jsftpnode.jsmodule and suited for the 0.4.xbranch of grunt.

Release History

  • 2017-11-07 v0.2.0 Dependency updates.
  • 2015-02-04 v0.1.10 An option to force output verbosity.
  • 2014-10-22 v0.1.9 Log successful uploads only in verbose mode.
  • 2014-10-13 v0.1.8 Allow empty strings to be used as login details.
  • 2014-09-03 v0.1.7 Restructured the code deailing with the authentication values to address some issues.
  • 2014-08-20 v0.1.6 Bug fix with the modules updates.
  • 2014-08-20 v0.1.5 Refresh of versions of used modules.
  • 2014-07-28 v0.1.4 Added a authPathconfiguration option.
  • 2014-05-05 v0.1.3 Added warning if an authKeyis provided and no .ftppassis found.
  • 2013-11-22 v0.1.1 Added compatibility with grunt0.4.2and switched to jsftp1.2.x.
  • 2013-08-26 v0.1.0 Switched to jsftp1.1.x.






扫码加入 JavaScript 社区