![\"Raspberry](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/01\/Raspberry-Pi-Remote-SSH-VS-Code.jpg?resize=1200%2C675&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nPrerequisites<\/h2>\n\n\n\n
If you’re reading this post, we assume that you are familiar with or are getting started with the Raspberry Pi. You can read our getting started guide below:<\/p>\n\n\n\n
- \n
- Getting Started with Raspberry Pi<\/a><\/li>\n<\/ul>\n\n\n\n
We assume you have an operating system installed on your Pi (Raspberry Pi OS or similar), you have enabled SSH on the Pi<\/strong>, and you know your Pi hostname<\/strong>, username, <\/strong>and password<\/strong> \u2014 all of this is set up during the installation process.<\/p>\n\n\n\n
We also assume you already have Visual Studio Code (VS Code) installed<\/a> on your computer.<\/p>\n\n\n\n
Installing Remote – SSH Extension on VS Code<\/h2>\n\n\n\n
First, you need to install the Remote – SSH<\/strong> extension on VS Code. Click on the Extensions <\/strong>icon on the left sidebar, search for remote<\/em>, and install the Remote – SSH<\/strong> extension.<\/p>\n\n\n
\n![\"Installing](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/01\/1-install-remote-ssh-vs-code.png?resize=750%2C449&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nCreate a Remote Connection with the Raspberry Pi on VS Code<\/h2>\n\n\n\n
After installing, a new Desktop <\/em>icon will show up on your sidebar. Click on that icon. Then, select Remote <\/strong>on the Remote Explorer<\/em> field. Then, Click on the +<\/strong> sign to add a new remote machine.<\/p>\n\n\n
\n![\"Create](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/01\/2-remote-explorer-ssh.png?resize=704%2C327&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nThen, you’ll be asked to run the SSH command to establish a communication with your host. <\/p>\n\n\n
\n![\"SSH](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/01\/3-ssh-comand-vs-code-raspberrypi.png?resize=554%2C100&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nAt this point, you need to know your Raspberry pi localhost name or IP address and username. For example, in my case:<\/p>\n\n\n\n
- \n
- localhost: raspberrypi2<\/strong><\/li>\n\n\n\n
- IP address: 192.168.1.106<\/strong><\/li>\n\n\n\n
- username: pi<\/strong><\/li>\n<\/ul>\n\n\n\n
So, I need to write the following command on that field:<\/p>\n\n\n\n
ssh pi@raspberrypi2<\/code><\/pre>\n\n\n\nOr, if I wanted to use the IP address instead:<\/p>\n\n\n\n
ssh pi@192.168.1.106<\/code><\/pre>\n\n\n\nThen, press Enter<\/strong>. You’ll be asked to select an SSH configuration file where VS code will save the SSH settings for that host. You can choose the one under the Users<\/em> folder.<\/p>\n\n\n
\n![\"SSH](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/01\/4-select-ssh-file.png?resize=607%2C140&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nYou’ll get a message saying the host was added.<\/p>\n\n\n
\n![\"New](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/01\/5-remote-host-added-vscode.png?resize=470%2C99&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nOn the top left corner, click on the Refresh<\/strong> <\/em>icon next to Remote<\/strong>.<\/p>\n\n\n
\n![\"Refresh](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/01\/6-refresh-remote-connections.png?resize=717%2C222&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nThe Raspberry Pi remote host will show up under the SSH <\/strong>menu. Then, click on the icon to connect in a new window as shown below.<\/p>\n\n\n
\n![\"New](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/01\/7-connect-to-remote-host-new-window.png?resize=750%2C228&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nThis will open a new window in VS Code dedicated to that remote machine (the Raspberry Pi). You’ll be asked to enter the Raspberry Pi password.<\/p>\n\n\n
\n![\"insert](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/01\/8-enter-password-remote-connection.png?resize=741%2C487&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nNow, you have a remote connection established with your Raspberry Pi. Notice that the Terminal window at the bottom is connected to your Raspberry Pi. Any commands that you run on that Terminal window, will be run on the Raspberry Pi.<\/p>\n\n\n\n
You can open Raspberry Pi folders on VS Code to start creating and writing files. Click on the Open Folder<\/strong> button to open a folder on your Raspberry Pi where you want to start creating or editing your files.<\/p>\n\n\n
\n![\"Open](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/01\/9-remote-connection-established-open-folder.png?resize=750%2C470&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nChoose a folder on your Raspberry Pi where you want to start creating your files.<\/p>\n\n\n
\n![\"Select](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/01\/10-open-folder-rpi-remote.png?resize=608%2C309&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nI chose the Documents<\/em> folder, but you can choose any other location on the Raspberry Pi. The Desktop <\/em>folder might also be a convenient location. After selecting the folder, click OK<\/strong>.<\/p>\n\n\n
\n![\"Select](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/01\/10-remote-RPi-Open-folder-VS-Code.png?resize=609%2C102&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nInsert your Raspberry Pi password again.<\/p>\n\n\n
\n![\"Enter](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/01\/12-enter-password-after-opening-folder.png?resize=632%2C120&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nYou’ll be asked if you trust the authors of the folder. Tick the option Trust the authors of all files in the parent folder ‘pi’<\/em>, and click Yes, I trust the authors<\/strong> to proceed.<\/p>\n\n\n
\n![\"Trust](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/01\/trust-authors-after-opening-folder.png?resize=535%2C338&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nIt will open the selected folder on the left sidebar. Now, you can use the VS Code menus to create new files and\/or folders under that folder. To open the Terminal window again, go to Terminal <\/strong>> New Terminal<\/strong>.<\/p>\n\n\n
\n![\"VS](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/01\/13-open-terminal-on-new-folder-VS-Code-Raspberry-Pi.png?resize=750%2C457&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nCreate a New Python File in the Raspberry Pi Remotely using VS Code<\/h2>\n\n\n\n
Once you’ve selected a working folder, you can create and write a new file in that folder. Hover your mouse over the “Documents<\/strong>” tab and click on the New File…<\/strong> button to create a new file. For demonstration purposes, you can create a file called test.py<\/em>.<\/p>\n\n\n
\n![\"Create](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/01\/13-create-new-file-test-py.png?resize=751%2C320&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nIt will create and open a new Python file called test.py<\/em> on the Documents <\/em>folder of the Raspberry Pi filesystem. You can write to that folder using VS Code environment. You can also delete or move that folder from VS Code.<\/p>\n\n\n
\n![\"New](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/01\/14-new-file-test-py.png?resize=750%2C412&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nAt this point, you can write your Python code on that file. For demonstration purposes, copy the following line to that file. This will simply print a message on the Terminal window when executed.<\/p>\n\n\n\n
print(\"Hello from Raspberry Pi\")<\/code><\/pre>\n\n\n\n![\"Python](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/01\/15-test-file-raspberry-pi-VS-Code-Remote.png?resize=750%2C356&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nSave your file. To save your file you can simply press Ctrl+S<\/strong> or Cmd+S<\/strong>.<\/p>\n\n\n\n
Now, you have a file called test.py<\/em> on your Raspberry Pi Documents <\/em>folder with that line of code.<\/p>\n\n\n\n
Running a Python File on the Raspberry Pi Remotely using VS Code (SSH)<\/h2>\n\n\n\n
To run that file simply call the command python<\/span> followed by the name of the file on the terminal window. In this case:<\/p>\n\n\n\n
python test.py<\/code><\/pre>\n\n\n\nPress Enter <\/strong>after typing the command.<\/p>\n\n\n\n
You should get “Hello from Raspberry Pi<\/span>” on the Terminal window, which is what that files does (prints a message). <\/p>\n\n\n
\n![\"Run](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/01\/16-test-py-remote-ssh-demonstration.png?resize=750%2C398&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nClosing the Remote Connection with Raspberry Pi on VS Code<\/h2>\n\n\n\n
To close the remote session, go to File <\/strong>> Close Remote Connection<\/strong>.<\/p>\n\n\n
\n![\"Close](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/01\/17-VS-Code-Raspberry-Pi-Close-Remote-Connection.png?resize=363%2C562&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nCongratulations! Now, you know how to code on Raspberry Pi remotely using VS Code on your computer using the Remote – SSH<\/strong> extension.<\/p>\n\n\n\n
Wrapping Up<\/h2>\n\n\n\n
In this tutorial, you learned a very convenient, practical, and easy way to program on your Raspberry Pi remotely via SSH using VS Code on your computer. Using the Remote – SSH extension you can create new files and folders on the Pi, and write and execute code using the command line.<\/p>\n\n\n\n
This is our favorite method to program the Raspberry Pi, because you don’t have to manually transfer the files from your computer to the Pi. Using this method, you’re already writing the code on the Pi. Additionally, the Terminal window allows you to execute commands remotely via SSH on the Pi, which is very practical to run your code.<\/p>\n\n\n\n
We hope you found this tutorial useful. If you also like to program boards like the ESP32 and ESP8266, you can also use VS Code for that. Learn how with the following tutorial:<\/p>\n\n\n\n
- \n
- Getting Started with VS Code and PlatformIO IDE for ESP32 and ESP8266 (Windows, Mac OS X, Linux Ubuntu)<\/a><\/li>\n<\/ul>\n\n\n\n
You can check all our Raspberry Pi projects on the following link:<\/p>\n\n\n\n
- IP address: 192.168.1.106<\/strong><\/li>\n\n\n\n
- localhost: raspberrypi2<\/strong><\/li>\n\n\n\n