Uploading and Downloading Files

On this page:

• Basics
• Uploading files and folders manually
• Uploading changed files automatically
• Uploading checked-in files immediately after commit
• Suppressing automatic upload
• Downloading files

Basics

There are the following main ways to synchronize project files with their copies on the local or remote server:

• Manually, through a menu command.
• Automatically, every time a file is updated. In this case, the default server configuration is used.

  You can additionally configure this upload method to have only manually saved files uploaded.

• Automatically after the changes to the files are checked in to your version control repository.

Besides uploading files, you can also have PyCharm download files that were deployed according to the default server configuration.

Uploading files and folders manually

1. Choose Tools | Deployment on the main menu.
2. Do one of the following:
   • To run the upload according to the default configuration, choose Upload to <default server configuration>.
   • To run the upload according to a specific configuration, choose Upload to. Then from the pop-up menu, select the server configuration that defines access to the required server.

Uploading changed files automatically

PyCharm considers a local file changed as soon as it is saved either automatically or manually. PyCharm performs automatic save on a regular scheduled basis. Manual save is invoked by choosing File | Save All on the main menu or pressing Ctrl+S.

1. Open the Options dialog box by doing one of the following:
   • On the main menu, choose Tools | Deployment | Options.
   • Open the Settings / Preferences Dialog by choosing File | Settings for Windows and Linux or PyCharm | Preferences for OS X. Expand the Build, Execution, Deployment node, and then click Options under Deployment.
2. In the Upload changed files automatically to the default server drop-down list, specify when you want PyCharm to upload changed files:
   • To have PyCharm upload any saved file no matter whether the save was invoked manually or automatically, choose Always.
   • To have PyCharm upload only files that were saved manually, choose On explicit save action.

Uploading checked-in files immediately after commit

1. Start checking in your changes.
2. In the After Commit area, choose the target server from the Upload file to drop-down list. Choose one of the existing server access configurations or create a new one: click the Browse button and configure access to the relevant server in the Deployment dialog box that opens.
3. To have PyCharm automatically upload checked in files to the chosen server, select the Always use selected server check box.

Suppressing automatic upload

1. Open the Options dialog box by doing one of the following:
   • On the main menu, choose Tools | Deployment | Options.
   • Open the Settings / Preferences Dialog by choosing File | Settings for Windows and Linux or PyCharm | Preferences for OS X. Expand the Build, Execution, Deployment node, and then click Options under Deployment.
2. From the Upload changed files automatically to the default server drop-down list, choose Never.

Downloading files

Choose Tools | Deployment | Download from <default server configuration> on the main menu. Note that this functionality is available only if you have previously appointed a configuration as default.