This document demonstrates how to install
code-server on various distros and
You can preview what occurs during the install process:
curl -fsSL https://code-server.dev/install.sh | sh -s -- --dry-run
To install, run:
curl -fsSL https://code-server.dev/install.sh | sh
You can modify the installation process by including one or more of the following flags:
--dry-run: echo the commands for the install process without running them.
--method: choose the installation method.
--method=detect: detect the package manager but fallback to
--method=standalone: install a standalone release archive into
--prefix=/usr/local: install a standalone release archive system-wide.
--version=X.X.X: install version
X.X.Xinstead of latest version.
--help: see usage docs.
When done, the install script prints out instructions for running and starting code-server.
If you prefer to install code-server manually, despite the detection
--dry-run feature, then continue on for
information on how to do this. The
install.sh script runs the
exact same commands presented in the rest of this document.
For Debian and Ubuntu, code-server will install the latest deb package.
For Fedora, CentOS, RHEL and openSUSE, code-server will install the latest RPM package.
For Arch Linux, code-server will install the AUR package.
For any unrecognized Linux operating system, code-server will install the
latest standalone release into
$PATHto run code-server.
For macOS, code-server will install the Homebrew package (if you don't have
Homebrew installed, code-server will install the latest standalone release
$PATHto run code-server.
For FreeBSD, code-server will install the npm package with
If you're installing code-server onto architecture with no releases,
code-server will install the npm package with
We recommend installing with
glibcxx< v3.4.18 on
glibc< v2.23, or
glibcxx< v3.4.21 on
Installing code-server with
npm builds native modules on install.
This process requires C dependencies; see our guide on [installing with yarn and npm]./npm.md for more information.
We publish self-contained
.tar.gz archives for every release on
GitHub. The archives bundle the
node binary and node modules.
We create the standalone releases using the npm package, and we then create the remaining releases using the standalone version.
The only requirement to use the standalone release is
glibc >= 2.17 and
glibcxx >= v3.4.18 on Linux (for macOS, there is no minimum system
To use a standalone release:
You can add
./bin/code-server to your
$PATH so that you can execute
code-server without providing full path each time.
Here is a sample script for installing and using a standalone code-server release on Linux:
mkdir -p ~/.local/lib ~/.local/bin curl -fL https://github.com/cdr/code-server/releases/download/v$VERSION/code-server-$VERSION-linux-amd64.tar.gz \ | tar -C ~/.local/lib -xz mv ~/.local/lib/code-server-$VERSION-linux-amd64 ~/.local/lib/code-server-$VERSION ln -s ~/.local/lib/code-server-$VERSION/bin/code-server ~/.local/bin/code-server PATH="~/.local/bin:$PATH" code-server # Now visit http://127.0.0.1:8080. Your password is in ~/.config/code-server/config.yaml
The standalone arm64 .deb does not support Ubuntu 16.04 or earlier. Please upgrade or build with yarn.
curl -fOL https://github.com/cdr/code-server/releases/download/v$VERSION/code-server_$VERSION_amd64.deb sudo dpkg -i code-server_$VERSION_amd64.deb sudo systemctl enable --now [email protected]$USER # Now visit http://127.0.0.1:8080. Your password is in ~/.config/code-server/config.yaml
The standalone arm64 .rpm does not support CentOS 7. Please upgrade or build with yarn.
curl -fOL https://github.com/cdr/code-server/releases/download/v$VERSION/code-server-$VERSION-amd64.rpm sudo rpm -i code-server-$VERSION-amd64.rpm sudo systemctl enable --now [email protected]$USER # Now visit http://127.0.0.1:8080. Your password is in ~/.config/code-server/config.yaml
# Install code-server from the AUR using yay. yay -S code-server sudo systemctl enable --now [email protected]$USER # Now visit http://127.0.0.1:8080. Your password is in ~/.config/code-server/config.yaml
# Install code-server from the AUR with plain makepkg. git clone https://aur.archlinux.org/code-server.git cd code-server makepkg -si sudo systemctl enable --now [email protected]$USER # Now visit http://127.0.0.1:8080. Your password is in ~/.config/code-server/config.yaml
brew install code-server brew services start code-server # Now visit http://127.0.0.1:8080. Your password is in ~/.config/code-server/config.yaml
# This will start a code-server container and expose it at http://127.0.0.1:8080. # It will also mount your current directory into the container as `/home/coder/project` # and forward your UID/GID so that all file system operations occur as your user outside # the container. # # Your $HOME/.config is mounted at $HOME/.config within the container to ensure you can # easily access/modify your code-server config in $HOME/.config/code-server/config.json # outside the container. mkdir -p ~/.config docker run -it --name code-server -p 127.0.0.1:8080:8080 \ -v "$HOME/.config:/home/coder/.config" \ -v "$PWD:/home/coder/project" \ -u "$(id -u):$(id -g)" \ -e "DOCKER_USER=$USER" \ codercom/code-server:latest
Our official image supports
arm32 support, you can
use a community-maintained code-server
You can install code-server using the Helm package manager.
Note: You will also need to build cdr/cloud-agent manually if you would like to use
code-server --linkon Windows.
We recommend installing code-server onto Raspberry Pi with
Please see code-server's Termux docs for more information.
We maintain one-click apps and install scripts for cloud providers such as DigitalOcean, Railway, Heroku, and Azure.
code-server can be completely uninstalled by removing the application directory, and your user configuration directory.
To delete settings and data:
rm -rf ~/.local/share/code-server ~/.config/code-server
If you installed with the install script, by default code-server will be in
~/.local/lib/code-server-<version> and you can remove it with
rm -rf. e.g.
rm -rf ~/.local/lib/code-server-*
To remove the code-server homebrew package, run:
brew remove code-server Alternatively brew uninstall code-server
To remove the code-server global module, run:
yarn global remove code-server
npm uninstall -g code-server
To uninstall, run:
sudo apt remove code-server