Configure FTP Passive Mode

This article explains passive mode, why it is normally enabled for modern NAT/firewall environments, and how changing it can help diagnose servers that require a different data-channel configuration.

What you need to know

  • Passive FTP is the practical default for most hosted/NAT/firewalled environments because the client initiates the data connection. Active mode may require inbound network reachability.

How to do it

  1. Edit the FTP Storage Connection.
  2. Locate the Use passive mode option.
  3. Keep passive mode enabled for most firewalled/NAT/hosted FTP servers. In passive mode the client opens the data connection, which generally works better through outbound-only firewalls.
  4. Disable it only when the FTP provider explicitly requires active mode and the network can accept the inbound data connection.
  5. Click Test Connection after changing the mode, then verify a listing and a small upload/download in a test Workspace.

Verify the result

  • Test Connection succeeds.
  • The displayed/usable root is exactly the intended root and no parent folder is reachable.
  • A normal authorized user can perform only the operations intended for that connection/Workspace role.

Troubleshooting

  • If the provider is unreachable, test the connection in Administrator before troubleshooting the Workspace UI.
  • Keep passwords, OAuth secrets/tokens, private keys, and unrestricted private paths out of public screenshots and support posts.

Community Discussion

For practical QCSB workflows and discussion with other Joomla site owners, visit the QC Storage Bridge Community. For private support, bug reports, account-specific entitlement issues, or feature requests, use the QuantaCade support system.