TeamCity
 
2017.1
You are viewing the documentation for an earlier version of TeamCity.
  1. TeamCity Documentation
  2. Administrator's Guide
  3. Managing Projects and Build Configurations
  4. Creating and Editing Build Configurations
  5. Configuring Build Steps
  6. Deployers
  7. FTP Upload

FTP Upload

Last modified: 20 April 2023

FTP Upload a llows deploying files/directories to an FTP server.

The settings common for all runners are described on a separate page; this page details the FTP Upload settings.

tip

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: e.g. 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 /subdir 127.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/diretories to be deployed. Ant-style wildcards like dir/**/*.zip and target directories like *.zip => winFiles,unix/distro.tgz => linuxFiles, where winFiles and linuxFiles are target directories, are supported.