TeamCity 2019.1 Help

FTP Upload

FTP Upload allows deploying files/directories to an FTP server.

The settings common for all runners are described in Configuring Build Steps; this page details the FTP Upload settings.

The fields below support parameter references: any text between percentage signs (%) is considered a reference to a property by TeamCity. To prevent TeamCity from treating the text in the percentage signs as a property reference, use two percentage signs to escape them: for example, if you want to pass "%Y%m%d%H%M%S" into the build, change it to "%%Y%%m%%d%%H%%M%%S".

Option

Description

Deployment Target

Target host

Specify an FTP server (usehostname or IP address) and a remote directory (relative to the FTP user's home).

To use an absolute *nix path, use %2F as the forward slash. For example:

ftp://hostname.com/hostname.com:34445/subdir127.0.0.1/%2Fetc/

Secure connection

Choose between an insecure (FTP) and a secure connection (FTPS, FTPES).

Deployment Credentials

Authentication method

Select either Anonymous (will submit username anonymous and a single space as the password) or username/password (for custom credentials)

FTP modes

FTP Mode

Select the passive or active mode

Transfer Mode

Optional. Select an FTP transfer mode to force: the ASCII or Binary FTP transfer modes (if the automatically detected mode leads to broken files transfer)

Deployment Source

Paths to sources

Specify the deployment sources as a newline- or comma-separated list of paths to files/directories.

The field supports Ant-style wildcard patterns (for example, dir/**/*.zip).
You can also specify a target directory to be created using the file => directory pattern (for example, *.zip => winFiles,unix/distro.tgz => linuxFiles will create the winFiles and linuxFiles directories, and respectively put the declared files inside them).