PyCharm 2019.3 Help

Uploading and Downloading Files

PyCharm provides the following main ways to upload project files and folders to deployment servers:

  • Manually, at any time through a menu command.

  • Automatically, every time a file is updated, or before starting a debugging session, or during a commit to your version control system.

For downloading files and folders, PyCharm supports only the manual mode.

PyCharm shows the logs in the File Transfer tool window (View | Tool Windows | File Transfer).

File Transfer tool window

Upload a file or folder manually

  • In the Project tool window, right-click a file or folder, then select Deployment | Upload to from the context menu, and choose the target deployment server or server group from the list.

    If the default server or server group is appointed, you can also select Upload to <default deployment server or server group>.

Upload locally changed files

  1. Switch to the Local Changes tab of the Version Control window Alt+9 to view the locally changed files.

  2. Right-click a file, then select Deployment | Upload to from the context menu, and choose the target deployment server or server group from the list. If the default server or server group group is appointed, you can also select Upload to <default deployment server or server group>.

See Manage Files under Version Control for details.

Upload files after synchronizing with a VCS repository

  1. Synchronize the contents of your local files with the VCS repository by pressing Ctrl+T or selecting VCS | <VCS> | Update from the main menu.

  2. Switch to the Update Info tab of the Version Control window Alt+9 .

  3. Right-click a file, then select Deployment | Upload to from the context menu, and choose the target deployment server or server group from the list. If the default server or server group is appointed, you can also select Upload to <default deployment server or server group>.

Upload checked-in files immediately after commit

  1. Start checking in your changes.

  2. In the After Commit area, choose the target server or server group from the Upload files to list. Choose one of the existing configurations or create a new one: click the Browse button and configure access to the relevant server or set up a server group in the Deployment dialog that opens.

  3. To have your selection applied automatically in the future, select the Always use selected server or group of servers checkbox.

Configure automatic upload of changed files to the default server or server group

PyCharm considers a local file changed as soon as it is saved either automatically or manually (File | Save All or Ctrl+S), see Working with source code. Changed files can be automatically uploaded only to the default deployment server.

  1. Open the Options dialog by doing one of the following:

    • From the main menu, choose Tools | Deployment | Options.

    • In the Settings/Preferences dialog Ctrl+Alt+S, go to Build, Execution, Deployment | Deployment | Options.

  2. From the Upload changed files automatically to the default server list, choose when you want PyCharm to upload changed files:

    • To upload any manually or automatically saved file, choose Always.

    • To upload only manually saved files, choose On explicit save action.

    • To suppress automatic upload, choose Never.

Download a file or folder

  • In the Remote Hosts tool window, select the required file or folder and choose Download from here from the context menu of the selection.

Download a file from the default deployment server

  • From the main menu, choose Tools | Deployment | Download from <default server>.

    PyCharm will prompt you to overwrite local files, if any.

Last modified: 5 December 2019