Skip to content

Variables (parametric stuff) ​

Syncplify Server! allows you to use variables—placeholders wrapped in double curly braces like —to make your configuration dynamic and adaptable. These variables are evaluated at run-time and replaced with their actual values, allowing the software to adjust settings for each session or user automatically.

Example:
Suppose you want each user to have a personal home directory using a single VFS definition. You can set the VFS target to C:\SFTPData\. When user john logs in, their files go to C:\SFTPData\john; for user jane, it's C:\SFTPData\jane. This way, you only need one VFS rule for all users.

NOTE

Variables are always written as . Not all variables are available everywhere—some only work in VFS settings, others only in banners. See the lists below for details.

These variables can be used inside a VFS target to parametrize its destination based on the current real-time value of each variable.

VariableExplanation
{{username}}The username (ID) of the currently authenticated user account
{{user_desc}}The description field (free text) of the currently authenticated user account
{{user_home}}The home directory for the LDAP user account (available exclusively for LDAP user/group accounts)
{{sess_custdata}}The first string in the Session.CustomData (if a script populated this value in a previously executed event-handler)
{{today}}The server-time current date (YYYYMMDD)
{{today_utc}}The UTC-time current date (YYYYMMDD)

These variables can be used to parametrize the following configuration settings:

  • The SFTP software ID
  • The SFTP banner
  • The FTP(E/S) greeting banner
  • The FTP(E/S) login message
  • The FTP(E/S) login failure message
  • The FTP(E/S) logout message
VariableExplanation
{{server_time}}The current server-time (ex: 2006-01-02 15:04:05.999999999 -0700 MST)
{{utc_time}}The current UTC-time (ex: 2006-01-02 15:04:05.999999999)
{{software_name}}Substituted with the words Syncplify Server!
{{process_name}}Substituted with the words Syncplify Server! Worker Service
{{software_ver}}Current software version (ex: 6.0.29)
{{cpu_load}}Current CPU load of the worker process (ex: 0.71%)
{{memory}}Current RAM (memory) used by the worker process (ex: 84 MB)
{{active_sessions}}Current number of active client sessions (ex: 42)