code-server/docs
Joe Previte f178f0400b
feat(e2e): add support running behind proxy (#5348)
* docs: update maintaining

* chore(e2e): add maxFailures to playwright

* fix(ci): skip submodule in e2e job

We don't need the submodules for the e2e job. This will speed up the
checkout step.

* feat(ci): add test-e2e-proxy job

This adds a new job to CI to run our tests behind Caddy and simulate
code-server running against a reverse-proxy.

* refactor: make e2e work with reverse proxy

This refactors the e2e test in a couple ways:
- remove setting cookie in localStorage (instead we pass --auth none)
- refactor address() method to account for reverse proxy logic

* Update test/e2e/models/CodeServer.ts

* Update test/playwright.config.ts

* Update test/utils/constants.ts

Co-authored-by: Asher <ash@coder.com>

* Update test/utils/helpers.ts

Co-authored-by: Asher <ash@coder.com>

Co-authored-by: Asher <ash@coder.com>
2022-08-09 18:24:37 +00:00
..
assets replace inline svgs with icon_path (#5395) 2022-08-01 20:20:39 +00:00
CODE_OF_CONDUCT.md Update docs/CODE_OF_CONDUCT.md 2021-02-03 11:08:06 -07:00
CONTRIBUTING.md docs: add troubleshooting section (#5313) 2022-07-15 19:30:03 +00:00
FAQ.md docs: Update some more links (#4806) 2022-02-01 09:45:19 -07:00
MAINTAINING.md feat(e2e): add support running behind proxy (#5348) 2022-08-09 18:24:37 +00:00
README.md chore: Improve coder/coder advertisement in README (#5425) 2022-08-08 19:21:55 +00:00
SECURITY.md docs: Update some more links (#4806) 2022-02-01 09:45:19 -07:00
android.md chore: upgrade Code to 1.66 (#5135) 2022-05-04 21:58:49 +00:00
collaboration.md release: 4.5.1 (#5354) 2022-07-19 12:34:01 -07:00
guide.md Update caddy installation steps (#5384) 2022-07-27 12:44:12 -05:00
helm.md release: 4.5.1 (#5354) 2022-07-19 12:34:01 -07:00
install.md Add #5174 comment on rsp install (#5294) 2022-08-01 16:04:41 +00:00
ios.md Update ios.md (#5079) 2022-04-12 11:32:49 -07:00
ipad.md docs: Update some more links (#4806) 2022-02-01 09:45:19 -07:00
link.md docs: Update some more links (#4806) 2022-02-01 09:45:19 -07:00
manifest.json replace inline svgs with icon_path (#5395) 2022-08-01 20:20:39 +00:00
npm.md chore: upgrade Code to 1.66 (#5135) 2022-05-04 21:58:49 +00:00
requirements.md docs: correct trial length (#5396) 2022-08-01 10:20:55 -05:00
termux.md docs: simplify termux installation process (#5078) 2022-04-12 15:42:22 -07:00
triage.md docs: Update some more links (#4806) 2022-02-01 09:45:19 -07:00
upgrade.md refactor(docs): clean up and restructure 2021-07-12 14:03:09 -05:00

README.md

code-server

"GitHub Discussions" "Join us on Slack" Twitter Follow codecov See latest

Run VS Code on any machine anywhere and access it in the browser.

Screenshot

Highlights

  • Code on any device with a consistent development environment
  • Use cloud servers to speed up tests, compilations, downloads, and more
  • Preserve battery life when you're on the go; all intensive tasks run on your server

Requirements

See requirements for minimum specs, as well as instructions on how to set up a Google VM on which you can install code-server.

TL;DR: Linux machine with WebSockets enabled, 1 GB RAM, and 2 CPUs

Getting started

There are four ways to get started:

  1. Using the install script, which automates most of the process. The script uses the system package manager if possible.
  2. Manually installing code-server
  3. Deploy code-server to your team with coder/coder
  4. Using our one-click buttons and guides to deploy code-server to a cloud provider

If you use the install script, 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

When done, the install script prints out instructions for running and starting code-server.

Note To manage code-server for a team on your infrastructure, see: coder/coder

We also have an in-depth setup and configuration guide.

Questions?

See answers to frequently asked questions.

Want to help?

See Contributing for details.

Hiring

Interested in working at Coder? Check out our open positions!

For Organizations

Want remote development for your organization or enterprise? Visit our website to learn more about Coder.