Quelltext der Seite Code-Server Install (Debian)

This article shows, how to manually install Coder's Code-Server on Debian running Apache webserver.

Code-Server is a web-based version of Visual Studio Code.

== Source ==

Code-Server on GitHub: https://github.com/coder/code-server

== Requirements ==

Code-Server version 4.0.0 and above requires Apache2 version 2.4.57 or higher. This is typically available on Debian 11 Bullseye.

On Debian 10 Buster only Apache2 version 2.4.38 is available. With this only Code-Server version 3.1.2 and lower is compatible

== Manual Install ==

This instructions are based on Coder's original documentation located here: 

https://coder.com/docs/code-server/latest/install#debian-ubuntu

<syntaxhighlight lang="bash">
curl -fOL https://github.com/coder/code-server/releases/download/v$VERSION/code-server_$VERSION_amd64.deb
sudo dpkg -i code-server_$VERSION_amd64.deb
sudo systemctl enable --now code-server@$USER
# Now visit http://127.0.0.1:8080. Your password is in ~/.config/code-server/config.yaml
</syntaxhighlight>

For this to work you have to specify the version which ''curl'' should download. You can find the available versions in the releases section of the GitHub repository: https://github.com/coder/code-server/releases

Look for the download links of the assets section.

Lets assume that the version you wish to install is 4.0.0 and the user for which code server should be installed is Bob then the script above should look as follows:

<syntaxhighlight lang="bash">
curl -fOL https://github.com/coder/code-server/releases/download/v4.0.0/code-server_4.0.0_amd64.deb
sudo dpkg -i code-server_4.0.0_amd64.deb
sudo systemctl enable --now code-server@$bob
# Now visit http://127.0.0.1:8080. Your password is in ~/.config/code-server/config.yaml
</syntaxhighlight>

curl downloads the file to the ''~/.cache/code-server'' directory (of your home directory).

== Uninstall ==

Find out which version is currently installed:

 sudo dpkg -l code-server

Uninstall

 sudo dpkg -r code-server         # Leave config files
 sudo dpkg -P code-server         # Purge and delete all config files

== Troubleshooting ==

=== Login Fails ===

'''Error description:''' Login fails with websockets error message.

'''Root cause:''' Code-Server 4.0.0 and higher requires websockets features which seem only be available on Apache2 2.4.48 or higher

'''Solutions:'''
# Upgrade to Debian 11 Bullseye. With Apache2 version 2.4.58, which is available on Debian 11 Bullseye Code-Server 4.0.0 or higher code-server works. See requirements section above
# Downgrade Code-Server to 3.1.2 or lower. See install/uninstall above

[[Category:Linux]]
[[Category:Terminal]]