Guides

Connecting with an FTP client

How to connect to TrueFTP with FileZilla, WinSCP, Cyberduck, and the command line using FTP over explicit TLS.

TrueFTP works with any standard FTP client that supports explicit TLS. Use the same connection details everywhere:

  • Host: ftp.trueftp.com
  • Port: 2121
  • Username: account-slug:username (e.g. acme:reports)
  • Encryption: Require explicit FTP over TLS

FileZilla

  1. Open File → Site Manager → New Site.
  2. Set Protocol to FTP - File Transfer Protocol.
  3. Host ftp.trueftp.com, Port 2121.
  4. Set Encryption to Require explicit FTP over TLS.
  5. Logon Type Normal, then enter your account-slug:username and password.
  6. Click Connect.

WinSCP

  1. New session, File protocol FTP.
  2. Encryption TLS/SSL Explicit encryption.
  3. Host ftp.trueftp.com, Port 2121.
  4. Enter username account-slug:username and password, then Login.

Cyberduck

  1. Open Connection, choose FTP-SSL (Explicit AUTH TLS).
  2. Server ftp.trueftp.com, Port 2121.
  3. Username account-slug:username, password, then Connect.

Command line (curl)

# Upload
curl -T local.csv --ftp-ssl \
  ftp://acme:reports:PASSWORD@ftp.trueftp.com:2121/incoming/
 
# Download
curl --ftp-ssl -o local.csv \
  ftp://acme:reports:PASSWORD@ftp.trueftp.com:2121/outgoing/report.csv

Passive mode

TrueFTP uses passive mode for data connections. Most clients enable it by default. If your client is behind a strict firewall, ensure outbound connections to the passive port range are allowed.

Troubleshooting

  • Login fails: Confirm the username is account-slug:username, not just the username.
  • TLS errors: Make sure the client is set to explicit TLS, not implicit.
  • Connection refused: Verify the port is 2121.
All docs