PyCharm 3.4.0 Web Help

File | Settings | Deployment - Options

Tools | Deployment | Options

settings

Use this page to specify additional configuration settings for uploading and downloading project files to and from local and remote servers. For more details about various server access configurations, see Working with Web Servers: Copying Files.

The options specified in this dialog box apply to all defined server configurations regardless of the server type (local, remote) and the data transfer protocol used. Protocol-specific options for server configurations of the type FTP/SFTP/FTPS are defined in the Advanced Options Dialog.

Item Description
Exclude items by name In this text box, specify patterns for the names of files and folders that you do not need to be deployed. Use semicolons as delimiters. Wildcards are welcome.

The exclusion is applied recursively. This means that if a matching folder has subfolders, the contents of these subfolders are not deployed either.

Operations logging Use this drop-down list to specify how much detailed logging you need to have. The available options are:
  • Errors only: select this option to have the log show only errors occurred during upload.
  • Brief: select this option to have all events reflected in the log but without details.
  • Detailed: select this option to have more details on the upload shown in the log, for example, full file paths.
Stop operation on the first error Select this check box to have data transfer stopped as soon as an error occurs.
Overwrite up-to-date files Do one of the following:
  • Select this check box to have all the files uploaded no matter whether they have been changed since the previous upload or not.
  • Clear the check box to upload only files that have been changed since the previous upload.
Preserve files timestamps Select this check box to prevent resetting timestamps of files on upload.
Delete target items when source ones do not exist If this check box is selected, any file in the destination directory will be removed if the file with this name is not involved in the current upload.

This option is applicable when synchronization if performed from the Project tool window or from the Remote Host tool window.

Create empty directories Select this check box to have an empty directory on the server created automatically if a new local directory has been created in your project since the last upload in the source folder.
Prompt when overwriting or deleting local items Select this check box to have PyCharm ask you for confirmation before overwriting or deleting local items for synchronization during download.
Upload changed files automatically to the default server From this drop-down list, choose when you want PyCharm to automatically upload a file to the default server. The available options are:
  • Always: choose this option to have a file uploaded upon each save, no matter automatic or explicitly invoked.
  • On explicit save action: choose this option to have a file uploaded after save only if this save was invoked manually by choosing File | Save all or pressing Ctrl+SCtrl+SCtrl+SCtrl+SCtrl+X, Ctrl+SCtrl+SCtrl+S or Ctrl+Shift+SCtrl+SCommand SCommand SCommand S.
  • Never: choose this option to suppress automatic upload.

Note

The default server configuration is appointed on the Deployment page by selecting the desired configuration in the list and clicking the Use as Default toolbar button icon_use_web_server_configuration_as_default.png.

Upload external changes Select this check box to have PyCharm upload also the local changes that were made using a third-party tool.
Override default permissions on files Select this check box to change the default permissions assigned to uploaded files on remote hosts. Click the Browse button browseButton to open the Files Default Permissions dialog box, where you can manage access to uploaded files on remote hosts by assigning permissions.
Override default permissions on folders Select this check box to change the default permissions assigned to uploaded folders on remote hosts. Click the Browse button browseButton to open the Folders Default Permissions dialog box, where you can manage access to uploaded folders on remote hosts by assigning permissions.
Warn when uploading over newer file Use this drop-down list to define the version-control policy to apply when uploading files to remote hosts. Depending on this choice, PyCharm either checks whether any changes have been made to the corresponding files on the remote host since you downloaded them or just overwrites the remote files.
  • No: choose this option to have the file on the remote host overwritten with its local copy silently. All the changes made to the remote file since your last synchronization will be abandoned.
  • Compare timestamp and size: if you choose this option, PyCharm performs two checks:
    1. Compares the sizes of the local and remote files.
    2. Compares the remote file timestamp set at the moment of the last synchronization with the current remote file timestamp.

    If the files differ in their size or the remote file timestamps differ, PyCharm opens a Difference Viewer for Files, where you can explore and integrate the differences.

    Note

    This type of check depends on the timezone setting. If the timezone setting on your local machine is different from that on the remote host, the check may be successful even though the file versions actually differ.

  • Compare content: when this option is chosen, PyCharm compares the content of the local and remote files. If any diversions are detected, PyCharm opens a Difference Viewer for Files, where you can explore and integrate the differences.
Notify about remote changes Select this check box to receive notifications about changes on the remote host. The check box is available only when the Compare timestamp and size: or Compare content: option is selected in the Warn when uploading over newer file drop-down list.
SFTP advanced options (IDE level)
Add new host key to known_hosts Choose whether PyCharm should ask about connecting to a host not mentioned in the file known_hosts. The following options are available:
  • Always: always connect and add its record to the file known_hosts.
  • Ask: ask whether PyCharm should connect to a host and add its record to the file known_hosts
  • Never: do not connect.
Hash hosts in known_hosts file If this check box is selected, the new host record will be stored in hash format.

See Also

Procedures:

Reference:

Web Resources: