Skip to content

FTP configuration parameters

Field / Property Type Description
system.ftp.server Boolean Enables FTP service. By default, it is disabled. You have to restart OpenKM after changing this parameter.
false
system.ftp.port Integer The port on which the FTP service listens. By default, it is 2121, although the default FTP port is 21 because it’s a reserved port and OpenKM must be run as an administrator to be able to use this port. You have to restart OpenKM after changing this parameter.
2121
system.ftp.data.port.range String Port range used on the server for data transmission. You should also open these ports in your firewall. By default, the range is 60000 to 60500 and they must be separated by a colon. You have to restart OpenKM after changing this parameter.
60000:60500
system.ftp.external.address String Set the IP address to use when FTP connections are proxied. Empty by default.
system.ftp.debug Integer Set the FTP debug flags. The greater the number, the more debug information is shown.
0

When set to active mode, the server will try to establish a connection to a client-side port chosen at random. Since this port is not likely to be one of the predetermined ports, the firewall will block any attempt to connect to it, resulting in no connection being established.

A passive configuration will not have this problem since the client will be the one initiating the connection. Of course, it’s possible for the server side to have a firewall too. However, since the server is expected to receive a greater number of connection requests compared to a client, it would be logical for the server administrator to adapt to the situation and open a selection of ports to support passive mode configurations.

More information at: