This configuration is simpler than it seems.
Creating a server configuration: specifying its name, type, and visibility
Open the Deployment page:
On Mac
⌘,on Windows and Linux File | Settings and click Deployment under Build, Execution, Deployment.Choose
Tools | Deployment | Configurationon the main menu. (see image below)

- In the left-hand pane, that shows a list of all the existing server configurations, click Add
+. The Add Server dialog box opens.

Specify the server configuration name in the Name text box. From the Type drop-down list, choose the server configuration type depending on the protocol you are going to use to exchange the data with the server. For more info about available protocols (FTP, SFTP, FTPS).
Use the Visible only for this project checkbox to configure the visibility of the server access configuration.
Click
OK. The Add Server dialog box closes and you return to the Connection tab of the Deployment dialog box.
Mapping local folders to folders on the server and the URL addresses to access them
- Switch to the Mappings tab.

In the Local Path text box, specify the full path to the desired folder in the project tree. In the simplest case it is the project root.
In the Deployment Path text box, specify the folder on the server where PyCharm will upload the data from the folder specified in the Local Path text box. Type the path to the folder relative to the server configuration root.
In the Web Path text box, type the path to the folder on the server relative to the server configuration root. Actually, type the relative path you typed in the Deployment Path text box.
How do I configure automatic upload of changed files to the default server
Open the Options dialog:
- Windows/Linux:
File | Settings | Build, Execution, Deployment | Deployment | Options - MacOS X:
PyCharm | Preferences | Build, Execution, Deployment | Deployment | Options
- Windows/Linux:

From the Upload changed files automatically to the default server list, choose:
- Always, to upload any manually or automatically saved file
- On explicit save action, to upload only manually saved files
- Never, to suppress automatic upload
That's it! You are ready to start developing.
I have just collected the most relevant information that is available in the official PyCharm documentation, and I have added some images that might guide the ones that are more visually oriented.
Answer from lmiguelvargasf on Stack OverflowPyCharm: Remote Development - Stack Overflow
Is there an equivalent of the VS Code remote development in PyCharm?
issues whilst setting up remote development in pycharm professional
python - Opening remote project in PyCharm - Stack Overflow
Videos
This configuration is simpler than it seems.
Creating a server configuration: specifying its name, type, and visibility
Open the Deployment page:
On Mac
⌘,on Windows and Linux File | Settings and click Deployment under Build, Execution, Deployment.Choose
Tools | Deployment | Configurationon the main menu. (see image below)

- In the left-hand pane, that shows a list of all the existing server configurations, click Add
+. The Add Server dialog box opens.

Specify the server configuration name in the Name text box. From the Type drop-down list, choose the server configuration type depending on the protocol you are going to use to exchange the data with the server. For more info about available protocols (FTP, SFTP, FTPS).
Use the Visible only for this project checkbox to configure the visibility of the server access configuration.
Click
OK. The Add Server dialog box closes and you return to the Connection tab of the Deployment dialog box.
Mapping local folders to folders on the server and the URL addresses to access them
- Switch to the Mappings tab.

In the Local Path text box, specify the full path to the desired folder in the project tree. In the simplest case it is the project root.
In the Deployment Path text box, specify the folder on the server where PyCharm will upload the data from the folder specified in the Local Path text box. Type the path to the folder relative to the server configuration root.
In the Web Path text box, type the path to the folder on the server relative to the server configuration root. Actually, type the relative path you typed in the Deployment Path text box.
How do I configure automatic upload of changed files to the default server
Open the Options dialog:
- Windows/Linux:
File | Settings | Build, Execution, Deployment | Deployment | Options - MacOS X:
PyCharm | Preferences | Build, Execution, Deployment | Deployment | Options
- Windows/Linux:

From the Upload changed files automatically to the default server list, choose:
- Always, to upload any manually or automatically saved file
- On explicit save action, to upload only manually saved files
- Never, to suppress automatic upload
That's it! You are ready to start developing.
I have just collected the most relevant information that is available in the official PyCharm documentation, and I have added some images that might guide the ones that are more visually oriented.
This is how I do remote development using PyCharm:
- Have a copy of the codebase on local machine
- Go to
pycharm -> tools -> Deplyomentand configure your remote destination. - If you select
Automatic Uploadthen as soon as you save any file on local machine, it will get uploaded to the remote, thereby giving you an impression of working on the remote. However, based on my experience, you should not selectAutomatic Uploadspecially if you like tosaveevery now and then. For such cases, upload manually by right clicking the file and selectingUpload to remoteonce you are ready to run/test. - In the terminal below, ssh to remote and run commands there.
I've tried searching for PyCharm remote development but I got a bit confused. It seems that there are a few ways to develop remotely. To be more specific, I want to be fully connected to a remote server and develop like I am in my local projects. The most suitable one seems to be the installation of a remote PyCharm instance but I am concerned about the resources it consumes.
Any ideas?
Was so excited to explore the "remote development" feature on pycharm, since i don't have enough computing resources to run in my local.
Spent entire day trying to set it up in multiple remote machines, but all of them failed.
Approach 1 - let local IDE download remote IDE of the same version, failed with logs , when i click on Download and start IDE option
Approach 2 - installed the tar.gz IDE of same version on remote, extracted it, and then ran remote-dev-server.sh registerBackendLocationForGateway resulted in the following o/p.
'/home/<user>/.cache/JetBrains/RemoteDev/userProvidedDist/_scratch_<user>_pycharm_2022.2.4' -> '/scratch/<user>/pycharm-2022.2.4'
after which followed approach 1, it had detected the IDE that i had installed on remote, failed again with logs, when i clicked on Open and start IDE
how can i debug this, what else can i look into ?
The way I access the projects on my raspberry pi using PyCharm is the following (This expects you to be using PyCharm Pro, supporting SSH connections):
- Mount the home folder on my local machine ( I use SFTP Drive on windows, under Linux use sshfs).
- Open the project from the mounted drive in PyCharm
- Go to Settings -> Project -> Project Interpreter and select the gear next to the Project Interpreter drop down. From there pick "Add Remote".
- Configure the remote interpreter you want to use.
If the PyCharm project was already created on the server, I guess your run configuration should be in order and running it should work out of the box.
If you created the PyCharm project on your local machine:
- If you have no run configuration yet, go to the file you want to run and do right-click -> Run yourfilename.py or simply hit Shift-F10
- The remote interpreter will complain about non existent files. Go to the dropdown in the top right corner, click it and select 'Edit Configurations'
- Change the script path and working directory to the actual remote directories. Remember, this is what your interpreter sees, and your interpreter is on your remote machine.
Hope this helps!
- The following will configure PyCharm Professional 2021.3.1 on Windows 10 to run a project on a remote Linux server. It's likely the configuration will be similar for PyCharm on macOS.
- Open PyCharm
- Create a New Project and select Pure Python
- Fill the Location and Remote project location, which may be new or existing.
- Select the ellipsis next to Interpreter under Previously configured interpreter
- Select SSH Interpreter and create New server connection
- Supply your credentials
- The default Interpreter will be
/usr/bin/python, but an alternate location may be provided, for example/home/.../anaconda3/bin/python3.9 
- Create the project
- Press Ctrl + Alt + S to open Settings
- Select Deployment under Build, Execution, Deployment
- Check Connection and Test Connection
- Check Mappings to verify Local path and Deployment path
- Check Connection and Test Connection
- Select Python Interpreter under Project:...
- Verify the remote interpreter is selected for the project.
- As long as this is the case, the code will run relative to the remote system.

- Verify the remote interpreter is selected for the project.
- Close Settings with OK, or Apply
- Select Deployment under Build, Execution, Deployment
- Use PUTTY or some other app to verify the project now exists on the remote system
- Right click the project and select Deployment for deployment options
Note
- This will likely require being connected to the corporate network through a VPN.




