Customize upload and download
File | Settings | Build, Execution, Deployment | Deployment for Windows and Linux
CLion | Preferences | Build, Execution, Deployment | Deployment for macOS
Besides the mandatory settings that ensure successful upload and download in various project – server setups, you can configure additional options to customize the interaction with the server. Most of these options apply to all server access configuration types. For FTP, FTPS, and SFTP server configurations, you can specify additional protocol-specific options.
Set common upload and download options
Press Ctrl+Alt+S to open the IDE settings and select Build, Execution, Deployment | Deployment | Options.
Alternatively, from the main menu, select Tools | Deployment | Options....
Specify additional settings:
To skip specific files or entire folders during upload and download, in the Exclude items by name field, specify the patterns that define the names of these files and folders.
Use semicolons
;
as delimiters, asterisks*
to match zero or more characters, and question marks?
to match a single character.For example, if you have a folder stylesheets with three files style.css, style1.css, and style2.scss, then
style*
excludes the entire folder,style?.css
excludes style.css, andstyle?.*
excludes style1.css and style2.scss.Learn more from Regular-Expressions.info.
The exclusion is applied recursively. This means that if a matching folder has subfolders, the contents of these subfolders are not deployed either.
For more information, see Exclude files and folders from upload/download.
Specify the details of the upload and download procedure by selecting or clearing the corresponding checkboxes.
Specify additional protocol-specific customization options
Press Ctrl+Alt+S to open the IDE settings and select Build, Execution, Deployment | Deployment.
Alternatively, from the main menu, select Tools | Deployment | Configuration....
Select a configured server and expand the Advanced group on the Connection tab to specify additional uploading settings that depend on the protocol:
SFTPFTPFTPSSelect the Use rsync for download/upload checkbox to have CLion use Rsync for uploading and downloading files, which can increase file transfer speeds.
Make sure that the paths to the
rsync
andssh
executables are provided on the Tools | Rsync page of the Settings/Preferences dialog (Ctrl+Alt+S).On macOS and Linux, the tools are preinstalled and the paths are filled automatically.
On Windows, you need to manually install Cygwin with the
rsync
andopenssh
packages first. The tools' executables are commonly located in the <Cygwin installation>\bin folder.
note
Rsync is only used for the manually triggered upload and download operations. All other deployment-related operations such as accessing files on a remote host, comparing deployed files and folders with their local versions, auto-uploading, and so on, are performed via regular SFTP means.
In the Number of connections field, specify the maximum number of connections to be supported simultaneously.
In the Send keep alive messages each field, specify how often you want CLion to send commands to the server to reset the timeout and thus preserve the connection.
In the Encoding for client-server communication field, specify the encoding that matches the encoding used by your server. Accept the default value if you are not sure that it supports UTF-8 encoding.