balenaCodeServer is a free Visual Studio Code based IDE that runs in your browser, served from your Raspberry Pi!
-
Based on the linuxserver.io code-server Docker image.
-
Includes the ZSH Docker Mod Which adds Oh-My-Zsh to your terminal.
- Raspberry Pi (tested on Pi3 B+ and Pi4)
Running this project is as simple as deploying it to a balenaCloud application. You can deploy it in one click by using the button below:
-
Type
<device-ip>:8080in a browser window (You can find your device IP address in the Balena Console) -
The default password for servers deployed with the balena deploy button is
b@13n4! -
The default sudo password is
b@13n4!sudo -
else the password for both is
password -
The GitHub and Balena CLIs are pre-installed. Authentication instructions here.
| Env Variable / Default Value | Function |
|---|---|
| PORT=8080 | code-server port. Default is 8080. |
| PUID=1000 | for UserID |
| PGID=1000 | for GroupID |
| SHELL=/usr/bin/zsh | Sets the default terminal shell to ZSH. To use BASH change to '/bin/bash' |
| TZ=Europe/London | Specify a timezone to use EG Europe/London, America/Los_Angeles |
| PASSWORD=password | Optional web gui password, if PASSWORD or HASHED_PASSWORD is not provided, there will be no auth. |
| HASHED_PASSWORD= | Optional web gui password, overrides PASSWORD, instructions on how to create it is below. |
| SUDO_PASSWORD=password | If this optional variable is set, user will have sudo access in the code-server terminal with the specified password. |
| SUDO_PASSWORD_HASH= | Optionally set sudo password via hash (takes priority over SUDO_PASSWORD var). Format is $type$salt$hashed. |
| PROXY_DOMAIN=code-server.my.domain | If this optional variable is set, this domain will be proxied for subdomain proxying. |
| DEFAULT_WORKSPACE=/config/workspace | If this optional variable is set, code-server will open this directory by default |