2020-05-14 15:17:17 +08:00
|
|
|
<!-- START doctoc generated TOC please keep comment here to allow auto update -->
|
|
|
|
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
|
2020-02-19 08:07:01 +08:00
|
|
|
# FAQ
|
|
|
|
|
2020-05-14 15:17:17 +08:00
|
|
|
- [Questions?](#questions)
|
|
|
|
- [What's the deal with extensions?](#whats-the-deal-with-extensions)
|
|
|
|
- [Where are extensions stored?](#where-are-extensions-stored)
|
|
|
|
- [How is this different from VS Code Codespaces?](#how-is-this-different-from-vs-code-codespaces)
|
|
|
|
- [How should I expose code-server to the internet?](#how-should-i-expose-code-server-to-the-internet)
|
|
|
|
- [How do I securely access web services?](#how-do-i-securely-access-web-services)
|
|
|
|
- [Sub-paths](#sub-paths)
|
2020-05-22 11:53:02 +08:00
|
|
|
- [Sub-domains](#sub-domains)
|
2020-05-15 10:26:57 +08:00
|
|
|
- [Multi-tenancy](#multi-tenancy)
|
2020-05-22 11:53:02 +08:00
|
|
|
- [Docker in code-server container?](#docker-in-code-server-container)
|
2020-05-14 15:17:17 +08:00
|
|
|
- [Collaboration](#collaboration)
|
|
|
|
- [How can I disable telemetry?](#how-can-i-disable-telemetry)
|
|
|
|
- [How does code-server decide what workspace or folder to open?](#how-does-code-server-decide-what-workspace-or-folder-to-open)
|
|
|
|
- [How do I debug issues with code-server?](#how-do-i-debug-issues-with-code-server)
|
2020-05-18 08:28:15 +08:00
|
|
|
- [Heartbeat File](#heartbeat-file)
|
2020-05-15 06:35:35 +08:00
|
|
|
- [How does the config file work?](#how-does-the-config-file-work)
|
2020-05-19 12:21:11 +08:00
|
|
|
- [Blank screen on iPad?](#blank-screen-on-ipad)
|
2020-05-22 11:53:02 +08:00
|
|
|
- [Isn't an install script piped into sh insecure?](#isnt-an-install-script-piped-into-sh-insecure)
|
2020-05-14 15:17:17 +08:00
|
|
|
- [Enterprise](#enterprise)
|
|
|
|
|
|
|
|
<!-- END doctoc generated TOC please keep comment here to allow auto update -->
|
|
|
|
|
2020-02-19 13:27:02 +08:00
|
|
|
## Questions?
|
|
|
|
|
2020-05-14 15:17:17 +08:00
|
|
|
Please file all questions and support requests at https://www.reddit.com/r/codeserver/.
|
|
|
|
|
|
|
|
The issue tracker is **only** for bugs.
|
2020-02-19 13:27:02 +08:00
|
|
|
|
2020-02-19 08:07:01 +08:00
|
|
|
## What's the deal with extensions?
|
|
|
|
|
2020-02-19 12:31:48 +08:00
|
|
|
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.
|
|
|
|
|
2020-05-23 03:38:03 +08:00
|
|
|
As a result, we have created our own marketplace for open source extensions.
|
2020-05-22 11:53:02 +08:00
|
|
|
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.
|
2020-02-19 12:31:48 +08:00
|
|
|
|
2020-04-04 02:09:32 +08:00
|
|
|
Issue [#1299](https://github.com/cdr/code-server/issues/1299) is a big one in making the experience here
|
2020-02-19 12:31:48 +08:00
|
|
|
better by allowing the community to submit extensions and repos to avoid waiting until the scraper finds
|
|
|
|
an extension.
|
|
|
|
|
2020-05-22 11:53:02 +08:00
|
|
|
To request an extension for the code-server marketplace, please open a new issue
|
|
|
|
and select the `Extension request` template.
|
|
|
|
|
2020-05-14 15:17:17 +08:00
|
|
|
If an extension is not available or does not work, you can grab its VSIX from its Github releases or
|
2020-05-15 07:53:15 +08:00
|
|
|
build it yourself. Then run the `Extensions: Install from VSIX` command in the Command Palette and
|
|
|
|
point to the .vsix file.
|
|
|
|
|
|
|
|
See below for installing an extension from the cli.
|
2020-02-19 08:07:01 +08:00
|
|
|
|
2020-05-18 04:53:08 +08:00
|
|
|
If you have your own custom marketplace, it is possible to point code-server to it by setting
|
|
|
|
`$SERVICE_URL` and `$ITEM_URL` to point to it.
|
|
|
|
|
2020-05-14 15:17:17 +08:00
|
|
|
## Where are extensions stored?
|
2020-02-19 08:07:01 +08:00
|
|
|
|
2020-05-14 15:17:17 +08:00
|
|
|
Defaults to `~/.local/share/code-server/extensions`.
|
2020-02-19 08:07:01 +08:00
|
|
|
|
2020-05-14 15:17:17 +08:00
|
|
|
If the `XDG_DATA_HOME` environment variable is set the data directory will be
|
2020-05-15 06:35:35 +08:00
|
|
|
`$XDG_DATA_HOME/code-server/extensions`. In general we try to follow the XDG directory spec.
|
2020-05-14 15:17:17 +08:00
|
|
|
|
|
|
|
You can install an extension on the CLI with:
|
2020-02-19 08:07:01 +08:00
|
|
|
|
2020-05-14 15:17:17 +08:00
|
|
|
```bash
|
|
|
|
# From the Coder extension marketplace
|
|
|
|
code-server --install-extension ms-python.python
|
2020-02-19 08:07:01 +08:00
|
|
|
|
2020-05-14 15:17:17 +08:00
|
|
|
# From a downloaded VSIX on the file system
|
|
|
|
code-server --install-extension downloaded-ms-python.python.vsix
|
|
|
|
```
|
|
|
|
|
|
|
|
## How is this different from VS Code Codespaces?
|
|
|
|
|
|
|
|
VS Code Codespaces is a closed source and paid service by Microsoft. It also allows you to access
|
|
|
|
VS Code via the browser.
|
2020-02-21 06:29:08 +08:00
|
|
|
|
2020-05-14 15:17:17 +08:00
|
|
|
However, code-server is free, open source and can be ran on any machine without any limitations.
|
2020-02-21 06:29:08 +08:00
|
|
|
|
2020-05-14 15:17:17 +08:00
|
|
|
While you can self host environments with VS Code Codespaces, you still need to an Azure billing
|
|
|
|
account and you access VS Code via the Codespaces web dashboard instead of directly connecting to
|
|
|
|
your instance.
|
|
|
|
|
|
|
|
## How should I expose code-server to the internet?
|
2020-02-19 08:07:01 +08:00
|
|
|
|
2020-05-15 07:53:15 +08:00
|
|
|
Please follow [./guide.md](./guide.md) for our recommendations on setting up and using code-server.
|
2020-05-14 15:17:17 +08:00
|
|
|
|
|
|
|
code-server only supports password authentication natively.
|
2020-02-19 08:07:01 +08:00
|
|
|
|
2020-04-27 20:41:52 +08:00
|
|
|
**note**: code-server will rate limit password authentication attempts at 2 a minute and 12 an hour.
|
|
|
|
|
2020-05-14 15:17:17 +08:00
|
|
|
If you want to use external authentication (i.e sign in with Google) you should handle this
|
2020-05-22 11:53:02 +08:00
|
|
|
with a reverse proxy using something like [oauth2_proxy](https://github.com/pusher/oauth2_proxy)
|
|
|
|
or [Cloudflare Access](https://teams.cloudflare.com/access).
|
2020-02-27 02:42:01 +08:00
|
|
|
|
2020-05-14 15:17:17 +08:00
|
|
|
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
|
2020-05-22 11:53:02 +08:00
|
|
|
the key with `--cert-key`.
|
2020-02-19 08:07:01 +08:00
|
|
|
|
|
|
|
If `code-server` has been passed a certificate it will also respond to HTTPS
|
2020-05-22 11:53:02 +08:00
|
|
|
requests and will redirect all HTTP requests to HTTPS.
|
2020-02-19 08:07:01 +08:00
|
|
|
|
2020-05-22 11:53:02 +08:00
|
|
|
You can use [Let's Encrypt](https://letsencrypt.org/) to get a TLS certificate
|
2020-02-19 08:07:01 +08:00
|
|
|
for free.
|
|
|
|
|
2020-05-20 01:46:19 +08:00
|
|
|
Again, please follow [./guide.md](./guide.md) for our recommendations on setting up and using code-server.
|
2020-05-14 15:17:17 +08:00
|
|
|
|
2020-04-03 02:40:01 +08:00
|
|
|
## How do I securely access web services?
|
2020-04-01 02:11:35 +08:00
|
|
|
|
2020-03-31 07:59:29 +08:00
|
|
|
code-server is capable of proxying to any port using either a subdomain or a
|
2020-04-03 02:40:01 +08:00
|
|
|
subpath which means you can securely access these services using code-server's
|
|
|
|
built-in authentication.
|
2020-03-31 07:59:29 +08:00
|
|
|
|
2020-05-22 11:53:02 +08:00
|
|
|
### Sub-paths
|
|
|
|
|
|
|
|
Just browse to `/proxy/<port>/`.
|
|
|
|
|
2020-03-31 07:59:29 +08:00
|
|
|
### Sub-domains
|
2020-04-01 02:11:35 +08:00
|
|
|
|
2020-04-03 02:40:01 +08:00
|
|
|
You will need a DNS entry that points to your server for each port you want to
|
|
|
|
access. You can either set up a wildcard DNS entry for `*.<domain>` if your domain
|
|
|
|
name registrar supports it or you can create one for every port you want to
|
|
|
|
access (`3000.<domain>`, `8080.<domain>`, etc).
|
|
|
|
|
|
|
|
You should also set up TLS certificates for these subdomains, either using a
|
|
|
|
wildcard certificate for `*.<domain>` or individual certificates for each port.
|
2020-03-31 07:59:29 +08:00
|
|
|
|
|
|
|
Start code-server with the `--proxy-domain` flag set to your domain.
|
|
|
|
|
|
|
|
```
|
2020-04-03 02:40:01 +08:00
|
|
|
code-server --proxy-domain <domain>
|
2020-03-31 07:59:29 +08:00
|
|
|
```
|
|
|
|
|
2020-04-03 02:40:01 +08:00
|
|
|
Now you can browse to `<port>.<domain>`. Note that this uses the host header so
|
2020-03-31 07:59:29 +08:00
|
|
|
ensure your reverse proxy forwards that information if you are using one.
|
|
|
|
|
2020-05-15 10:26:57 +08:00
|
|
|
## Multi-tenancy
|
2020-02-19 08:07:01 +08:00
|
|
|
|
2020-05-24 22:08:05 +08:00
|
|
|
If you want to run multiple code-servers on shared infrastructure, we recommend using virtual
|
2020-02-19 12:31:48 +08:00
|
|
|
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](https://kubevirt.io) to give each
|
2020-05-22 11:53:02 +08:00
|
|
|
user a virtual machine instead of just a container.
|
2020-02-19 12:31:48 +08:00
|
|
|
|
2020-05-22 11:53:02 +08:00
|
|
|
## Docker in code-server container?
|
2020-02-19 12:31:48 +08:00
|
|
|
|
2020-05-22 11:53:02 +08:00
|
|
|
If you'd like to access docker inside of code-server, we'd recommend running a `docker:dind` container
|
|
|
|
and mounting in a directory to share between `dind` and the `code-server` container at `/var/run`.
|
|
|
|
After, install the docker CLI in the code-server container and you should be able to access the
|
|
|
|
daemon as the socket will be shared at `/var/run/docker.sock`.
|
2020-02-19 12:31:48 +08:00
|
|
|
|
|
|
|
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
|
|
|
|
|
2020-05-14 15:17:17 +08:00
|
|
|
We understand the high demand but the team is swamped right now.
|
|
|
|
|
2020-05-22 11:53:02 +08:00
|
|
|
You can subscribe to [#33](https://github.com/cdr/code-server/issues/33) for updates.
|
2020-02-19 08:07:01 +08:00
|
|
|
|
|
|
|
## How can I disable telemetry?
|
|
|
|
|
|
|
|
Use the `--disable-telemetry` flag to completely disable telemetry. We use the
|
|
|
|
data collected only to improve code-server.
|
2020-02-19 12:31:48 +08:00
|
|
|
|
2020-04-08 06:49:50 +08:00
|
|
|
## How does code-server decide what workspace or folder to open?
|
|
|
|
|
|
|
|
code-server tries the following in order:
|
|
|
|
|
|
|
|
1. The `workspace` query parameter.
|
|
|
|
2. The `folder` query parameter.
|
2020-04-17 00:50:53 +08:00
|
|
|
3. The workspace or directory passed on the command line.
|
|
|
|
4. The last opened workspace or directory.
|
2020-04-08 06:49:50 +08:00
|
|
|
|
2020-04-21 07:45:04 +08:00
|
|
|
## How do I debug issues with code-server?
|
|
|
|
|
|
|
|
First run code-server with at least `debug` logging (or `trace` to be really
|
|
|
|
thorough) by setting the `--log` flag or the `LOG_LEVEL` environment variable.
|
|
|
|
`-vvv` and `--verbose` are aliases for `--log trace`.
|
|
|
|
|
|
|
|
```
|
|
|
|
code-server --log debug
|
|
|
|
```
|
|
|
|
|
|
|
|
Once this is done, replicate the issue you're having then collect logging
|
|
|
|
information from the following places:
|
|
|
|
|
2020-05-15 06:35:35 +08:00
|
|
|
1. stdout
|
2020-05-18 10:47:23 +08:00
|
|
|
2. The most recently created directory in the `~/.local/share/code-server/logs` directory.
|
2020-04-21 07:45:04 +08:00
|
|
|
3. The browser console and network tabs.
|
|
|
|
|
|
|
|
Additionally, collecting core dumps (you may need to enable them first) if
|
|
|
|
code-server crashes can be helpful.
|
|
|
|
|
2020-05-18 08:28:15 +08:00
|
|
|
## Heartbeat File
|
2020-04-21 07:45:04 +08:00
|
|
|
|
2020-05-14 15:17:17 +08:00
|
|
|
`code-server` touches `~/.local/share/code-server/heartbeat` once a minute as long
|
|
|
|
as there is an active browser connection.
|
|
|
|
|
|
|
|
If you want to shutdown `code-server` if there hasn't been an active connection in X minutes
|
2020-05-15 06:35:35 +08:00
|
|
|
you can do so by continuously checking the last modified time on the heartbeat file and if it is
|
2020-05-22 11:53:02 +08:00
|
|
|
older than X minutes, kill `code-server`.
|
2020-05-10 16:15:29 +08:00
|
|
|
|
2020-05-14 15:17:17 +08:00
|
|
|
[#1636](https://github.com/cdr/code-server/issues/1636) will make the experience here better.
|
2020-04-21 07:45:04 +08:00
|
|
|
|
2020-05-15 06:35:35 +08:00
|
|
|
## How does the config file work?
|
|
|
|
|
|
|
|
When `code-server` starts up, it creates a default config file in `~/.config/code-server/config.yaml` that looks
|
|
|
|
like this:
|
|
|
|
|
|
|
|
```yaml
|
|
|
|
bind-addr: 127.0.0.1:8080
|
|
|
|
auth: password
|
|
|
|
password: mewkmdasosafuio3422 # This is randomly generated for each config.yaml
|
|
|
|
cert: false
|
|
|
|
```
|
|
|
|
|
|
|
|
Each key in the file maps directly to a `code-server` flag. Run `code-server --help` to see
|
|
|
|
a listing of all the flags.
|
|
|
|
|
|
|
|
The default config here says to listen on the loopback IP port 8080, enable password authorization
|
|
|
|
and no TLS. Any flags passed to `code-server` will take priority over the config file.
|
|
|
|
|
|
|
|
The `--config` flag or `$CODE_SERVER_CONFIG` can be used to change the config file's location.
|
|
|
|
|
2020-05-18 08:27:45 +08:00
|
|
|
The default location also respects `$XDG_CONFIG_HOME`.
|
|
|
|
|
2020-05-19 12:21:11 +08:00
|
|
|
## Blank screen on iPad?
|
|
|
|
|
|
|
|
Unfortunately at the moment self signed certificates cause a blank screen on iPadOS
|
|
|
|
|
|
|
|
There does seem to a way to get it to work if you create your own CA and create a
|
|
|
|
certificate using the CA and then import the CA onto your iPad.
|
|
|
|
|
|
|
|
See [#1566](https://github.com/cdr/code-server/issues/1566#issuecomment-623159434).
|
|
|
|
|
2020-05-22 11:53:02 +08:00
|
|
|
## Isn't an install script piped into sh insecure?
|
2020-05-22 10:16:16 +08:00
|
|
|
|
|
|
|
Please give
|
|
|
|
[this wonderful blogpost](https://sandstorm.io/news/2015-09-24-is-curl-bash-insecure-pgp-verified-install) by
|
|
|
|
[sandstorm.io](https://sandstorm.io) a read.
|
|
|
|
|
2020-02-19 12:31:48 +08:00
|
|
|
## Enterprise
|
|
|
|
|
|
|
|
Visit [our enterprise page](https://coder.com) for more information about our
|
|
|
|
enterprise offerings.
|