FTP (File Transfer Protocol) is one of the oldest and most widely used protocols on the internet. It is designed to transfer files between an FTP client and an FTP server.
The Eco Time FTP Manager includes a built-in FTP client that allows Eco Time to automatically upload, download, and synchronise files and directories with an FTP server. It is typically used for system integrations, automated data exchanges, and scheduled file transfers.
How FTP Works
FTP differs from most modern network protocols because it uses two separate connections between the client and the server:
Control Connection
Used for commands and responses (login, directory listing requests, file commands, etc.).
Data Connection
Created only when data needs to be transferred. The actual file or directory content is transmitted over this connection.
Originally, the FTP server initiated the data connection back to the client. While this worked in the early days of the internet, it requires special firewall and network configuration and is now considered a security risk. As security standards evolved, this approach became impractical.
Passive Mode FTP
To address these security concerns, Passive Mode FTP was introduced.
In passive mode:
The client initiates both the control and data connections
This significantly improves compatibility with firewalls and modern network security policies
Passive mode is now the industry standard and is required by most FTP servers
Eco Time FTP Manager supports passive mode, and it is enabled by default.
Secure FTP Protocols
As security requirements increased, FTP was extended to support encrypted connections.
Eco Time FTP Manager supports the following secure FTP options:
Secure FTP (FTPS)
FTP over TLS
Explicit SSL (FTP-ES)
Implicit SSL
Implicit SSL (Control only)
No SSL (not recommended)
Eco Time FTP Manager Features
Eco Time FTP Manager is configurable to perform the following automated actions:
Download a single file from an FTP server
Upload a single file to an FTP server
Download an entire directory from an FTP server
Upload an entire directory to an FTP server
Execute transfers at configurable time intervals
Run interactively or as a Windows service
User Interface Overview
The Eco Time FTP Manager consists of five tabs, each serving a specific purpose:
Options
FTP Server Settings
FTP Manager Settings
FTP Manager Log
FTP Log
Services
Options
The Options tab allows manual execution of FTP operations, including:
Get file from FTP server
Send file to FTP server
Download a directory from the FTP server
Upload a directory to the FTP server
To manually execute an operation:
Select the desired option
Click the Select button
If Display Progress is enabled, real-time progress will be shown
This tab is typically used for testing and validation before enabling automated or service-based execution.
FTP Server Settings
The FTP Server Settings tab defines the connection details for the FTP server.
Configuration Fields
FTP Server Host IP - A domain name or IP address of the FTP server
FTP Port - The port used for FTP communication (Refer to Appendix A – FTP Ports for details)
FTP User Login - Username for FTP authentication
FTP User Password - Password for FTP authentication
Passive Mode - Enables or disables passive mode (Recommended and required for most modern servers)
FTP SSL Mode - Available options:
No SSL (not recommended)
Implicit SSL (Control)
Implicit SSL
Explicit SSL
Secure FTP
Transfer Mode
Binary
Non-binary (ASCII)
Binary mode is recommended for most file types.
FTP Manager Settings
The FTP Manager Settings tab controls directory locations and scheduling.
Remote File Name (on FTP Server)
This option is only used in the case of single file upload or download transfer option.
Remote File Name sets the file name which will be placed on the FTP server
Note When the file is places in a subdirectory on the FTP Server, the forward slash "/" structure is used. Do not place a forward slash "/" at the start of the file name
Remote Directories (on FTP Server)
FTP Remote Inbox Directory Example: /inbox
FTP Remote Outbox Directory - Example: /outbox
Local Directories (on Eco Time Server)
FTP Local Inbox Directory
Recommended name: FTP Inbox
This directory is automatically created when Eco Time FTP Manager runs.
FTP Local Outbox Directory
Recommended name: FTP Outboxbox
Automatically created when Eco Time FTP Manager runs.
Local File Name (on Eco Time Server)
This option is only used in the case of single file upload or download transfer option.
Local File Name sets the file name which will be transferred to the FTP server
Note The local outbox directory path is appended to the local file name on transfer, which means the file needs to be placed in the local outbox directory or a subdirectory thereof. Do not place a back slash "\" at the start of the file name
Scheduling Options
FTP Download Interval - Interval (in minutes) to check for files or directories available for download
FTP Upload Interval - Interval (in minutes) to check for files in the local outbox that must be uploaded
Enable / Disable Options
Enable File Upload
Enable File Download
Enable Directory Upload
Enable Directory Download
These options should be configured based on the specific integration requirements.
FTP Manager Log
The Log displays detailed runtime information, including:
File and directory checks
Connection status
Login success or failure
Data transfer progress
Error messages
The log is essential for troubleshooting and debugging.
⚠️ Note:
For full visibility, Eco Time FTP Manager should be run as a process, not as a service, when reviewing logs interactively.
FTP Log
The Log displays detailed runtime information, including:
FTP client raw transfer information
FTP client raw transfer progress
Additional FTP batch process raw information
Error messages
The log is essential for troubleshooting and debugging
The log is cleared and refershed on every transfer batch process
Services Tab
The Services tab allows Eco Time FTP Manager to be:
Installed as a Windows service
Removed as a Windows service
Started and stopped as a service
Run automatically in the background without user interaction
This mode is recommended for production environments where unattended operation is required.
Appendix A – Default FTP Ports
This appendix describes the default network ports used by the various FTP and SFTP protocols. Understanding these ports is important when configuring firewalls, routers, and the Eco Time FTP Manager.
FTP (Unsecured)
FTP (File Transfer Protocol) without encryption.
Control Port: 21
Data Ports:
Active mode: initiated by the server (dynamic)
Passive mode: assigned by the server (configurable range)
⚠️ Note: Unsecured FTP is not recommended because usernames, passwords, and data are transmitted without encryption.
FTP-ES (Explicit FTP over TLS)
FTP-ES uses TLS encryption that is explicitly initiated after the FTP session is established.
Control Port: 21
Data Ports:
Passive mode: server-defined range
✔️ This is the most commonly used and recommended secure FTP configuration.
FTP-S (Implicit FTP over TLS)
FTP-S starts TLS encryption immediately when the connection is opened.
Control Port: 990
Data Ports:
Passive mode: typically 989 or a configurable range
⚠️ Note: FTP-S is less flexible than FTP-ES and is no longer enabled by default on some modern FTP servers.
SFTP (SSH File Transfer Protocol)
SFTP is a completely different protocol from FTP and operates over SSH.
Control and Data Port: 22
Summary of Default Ports
Protocol
Security
Default Port
FTP
None
21
FTP-ES (Explicit TLS)
TLS
21
FTP-S (Implicit TLS)
TLS
990
SFTP (SSH)
SSH
22
Firewall and Network Notes
Ensure that passive data ports are allowed through firewalls
For FTP-ES and FTP-S, TLS inspection or deep packet inspection must be correctly configured if enabled
For production environments, FTP-ES in passive mode is strongly recommended
FTP (File Transfer Protocol) is one of the oldest and most widely used protocols on the internet. It is designed to transfer files between an FTP client and an FTP server.
The Eco Time FTP Manager includes a built-in FTP client that allows Eco Time to automatically upload, download, and synchronise files and directories with an FTP server. It is typically used for system integrations, automated data exchanges, and scheduled file transfers.
FTP differs from most modern network protocols because it uses two separate connections between the client and the server:
Used for commands and responses (login, directory listing requests, file commands, etc.).
Created only when data needs to be transferred. The actual file or directory content is transmitted over this connection.
To address these security concerns, Passive Mode FTP was introduced.
In passive mode:
As security requirements increased, FTP was extended to support encrypted connections.
Eco Time FTP Manager supports the following secure FTP options:
Eco Time FTP Manager is configurable to perform the following automated actions:
The Eco Time FTP Manager consists of five tabs, each serving a specific purpose:
The Options tab allows manual execution of FTP operations, including:
To manually execute an operation:
This tab is typically used for testing and validation before enabling automated or service-based execution.
The FTP Server Settings tab defines the connection details for the FTP server.
Configuration Fields
The FTP Manager Settings tab controls directory locations and scheduling.
The Log displays detailed runtime information, including:
⚠️ Note: For full visibility, Eco Time FTP Manager should be run as a process, not as a service, when reviewing logs interactively.
The Log displays detailed runtime information, including:
The Services tab allows Eco Time FTP Manager to be:
This mode is recommended for production environments where unattended operation is required.
This appendix describes the default network ports used by the various FTP and SFTP protocols. Understanding these ports is important when configuring firewalls, routers, and the Eco Time FTP Manager.
⚠️ Note: Unsecured FTP is not recommended because usernames, passwords, and data are transmitted without encryption.
✔️ This is the most commonly used and recommended secure FTP configuration.
FTP-S starts TLS encryption immediately when the connection is opened.
⚠️ Note: FTP-S is less flexible than FTP-ES and is no longer enabled by default on some modern FTP servers.
SFTP is a completely different protocol from FTP and operates over SSH.