This article will walk you through the step-by-step process of setting up your Raspberry Pi into a remote Linux development environment. You can access this setup on your local network.

This environment can be used for web and software development. It will give you complete access to the Raspberry Pi hardware remotely.

To achieve this, we are going to use code-server. It is an open source project by the folks at Coder.

If you a Microsoft Visual Studio Code user, you will like this a lot because this project is based on VS Code.

You will have access to the Terminal the same way as you would have it on a regular VS Code instance.

It is recommended that you use a Raspberry Pi 2, 3 or 4, these models have above 1 GB memory and it will perform better.

The example above is what the environment would look like.

Setting up the environment.

I have used Ubuntu for my Raspberry Pi, but this should also work on Raspbian. You will need at least SSH access to the Pi to follow along.

Open Terminal or SSH instance.

Run the following command.

The command below will install and setup code-server.

curl -fsSL | sh
Code language: JavaScript (javascript)

To enable code-server as a service run the following command.

sudo systemctl enable --now code-server@$USER
Code language: PHP (php)

To start code-server run this command.

sudo systemctl start code-server@$USER
Code language: PHP (php)

At this point code-server is running locally on, this can be accessed internally on the Pi. To access it on the network we will reverse proxy it using NGINX.

Installing nginx.

sudo apt install nginx

After NGINX has been installed.

Enable it on startup, so it starts when the Raspberry Pi turns on.

sudo systemctl enable nginx.service
Code language: CSS (css)

Open the NGINX config file. I have used nano, you can use whatever you like.

sudo nano /etc/nginx/sites-enabled/default
Code language: JavaScript (javascript)

Replace the content with this or comment everything else using # and add the lines below.

server { listen 80; listen [::]:80; location / { proxy_pass http://localhost:8080/; proxy_set_header Host $host; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection upgrade; proxy_set_header Accept-Encoding gzip; } }
Code language: PHP (php)

Now visit the IP address of your Raspberry Pi, this should display you a page like the screenshot below.

The password for it is located in ~/.config/code-server/config.yaml.

Run cat to read the file data.

cat ~/.config/code-server/config.yaml
Code language: JavaScript (javascript)

The file will consist of a line that says “password:” you enter the string into the code-server page and hit submit, this will open code-server page.

You can edit the password by editing the password string in the config.yaml.

You can get your Raspberry Pi IP address by running ip a in Terminal.

ip a

Opening a project on code-server.

I created a projects folder.

You can access the menu by pressing the three lines on the top left.

File menu on code-server

After choosing Open Folder, you will get a drop down prompt to select the folder or a folder inside the folder, example below.

Choose folder in code-server

Now you have a complete Linux development environment running on your Raspberry Pi and you can access it remotely.

That’s it folks, if you have any questions or want me to cover a topic, leave a comment below.

Darryl Dias

I’m Darryl. I’m a 3D Artist, Programmer and Linux enthusiast. On this site I share my insights, tips and tricks, tutorials, methods and best practices.

Leave a comment

Your email address will not be published. Required fields are marked *