code-server/doc/FAQ.md

4.4 KiB

FAQ

Questions?

Please file all questions and support requests at https://www.reddit.com/r/codeserver/ The issue tracker is only for bugs.

What's the deal with extensions?

Unfortunately, the Microsoft VS Code Marketplace license prohibits use with any non Microsoft product.

See https://cdn.vsassets.io/v/M146_20190123.39/_content/Microsoft-Visual-Studio-Marketplace-Terms-of-Use.pdf

Marketplace Offerings are intended for use only with Visual Studio Products and Services and you may only install and use Marketplace Offerings with Visual Studio Products and Services.

As a result, Coder has created its own marketplace for open source extensions. It works by scraping GitHub for VS Code extensions and building them. It's not perfect but getting better by the day with more and more extensions.

Issue https://github.com/cdr/code-server/issues/1299 is a big one in making the experience here better by allowing the community to submit extensions and repos to avoid waiting until the scraper finds an extension.

If an extension does not work, try to grab its VSIX from its Github releases or build it yourself and copy it to the extensions folder.

How is this different from VS Code Online?

VS Code Online is a closed source managed service by Microsoft and only runs on Azure.

code-server is open source and can be freely ran on any machine.

How should I expose code-server to the internet?

By far the most secure method of using code-server is via sshcode as it runs code-server and then forwards its port over SSH and requires no setup on your part other than having a working SSH server.

If you cannot use sshcode, then you will need to ensure there is some sort of authorization in front of code-server and that you are using HTTPS to secure all connections.

By default when listening externally, code-server enables password authentication using a randomly generated password so you can use that. You can set the PASSWORD environment variable to use your own instead. If you want to handle authentication yourself, use --auth none to disable password authentication.

For HTTPS, you can use a self signed certificate by passing in just --cert or pass in an existing certificate by providing the path to --cert and the path to its key with --cert-key.

If code-server has been passed a certificate it will also respond to HTTPS requests and will redirect all HTTP requests to HTTPS. Otherwise it will respond only to HTTP requests.

You can use Let's Encrypt to get an SSL certificate for free.

x86 releases?

node has dropped support for x86 and so we decided to as well. See nodejs/build/issues/885.

Alpine builds?

Just install libc-dev and code-server should work.

Multi Tenancy

If you want to run multiple code-server's on shared infrastructure, we recommend using virtual machines with a VM per user. This will easily allow users to run a docker daemon. If you want to use kubernetes, you'll definitely want to use kubevirt to give each user a virtual machine instead of just a container. Docker in docker while supported requires privileged containers which are a security risk in a multi tenant infrastructure.

Docker in code-server docker container?

If you'd like to access docker inside of code-server, we'd recommend running a docker:dind container and mounting in a /var/run directory to share between that and the code-server container. Install the docker CLI in the code-server container and you should be able to access the daemon.

In order to make volume mounts work, mount the home directory in the code-server container and the dind container at the same path. i.e you'd volume mount a directory from the host to /home/coder on both. This will allow any volume mounts in the home directory to work. Similar process to make volume mounts in any other directory work.

Collaboration

At the moment we have no plans for multi user collaboration on code-server but we understand this is a heavily requested feature and will work on it when the time is right.

How can I disable telemetry?

Use the --disable-telemetry flag to completely disable telemetry. We use the data collected only to improve code-server.

Enterprise

Visit our enterprise page for more information about our enterprise offerings.