Documentation fixes
This commit is contained in:
parent
15cd727b96
commit
7dcfde7329
15
README.md
15
README.md
|
@ -2,6 +2,10 @@
|
|||
|
||||
Run [VS Code](https://github.com/Microsoft/vscode) on any machine anywhere and access it in the browser.
|
||||
|
||||
![Screenshot](./doc/assets/screenshot.png)
|
||||
|
||||
## Highlights
|
||||
|
||||
- **Code everywhere:** Code on your Chromebook, tablet, and laptop with a
|
||||
consistent dev environment. Develop on a Linux machine and pick up from any
|
||||
device with a web browser.
|
||||
|
@ -9,15 +13,12 @@ Run [VS Code](https://github.com/Microsoft/vscode) on any machine anywhere and a
|
|||
Preserve battery life when you're on the go since all intensive tasks runs on your server.
|
||||
Make use of a spare computer you have lying around and turn it into a full development environment.
|
||||
|
||||
![Example gif](./doc/assets/screenshot.png)
|
||||
|
||||
## Getting Started
|
||||
|
||||
For a full setup and walkthrough, please see [./doc/guide.md](./doc/guide.md).
|
||||
|
||||
## Install
|
||||
|
||||
We have a script to install code-server on Linux or macOS preferring to use the system package manager.
|
||||
[We have a script](./install.sh) to install code-server for Linux or macOS.
|
||||
It tries to use the system package manager if possible.
|
||||
|
||||
First run to print out the install process:
|
||||
|
||||
|
@ -31,7 +32,9 @@ Now to actually install:
|
|||
curl -fsSL https://code-server.dev/install.sh | sh
|
||||
```
|
||||
|
||||
Docs on the install script, manual installation and docker instructions are at [./doc/install.md](./doc/install.md).
|
||||
The install script will print out how to run and start using code-server.
|
||||
|
||||
Docs on the install script, manual installation and docker image are at [./doc/install.md](./doc/install.md).
|
||||
|
||||
## FAQ
|
||||
|
||||
|
|
|
@ -11,10 +11,14 @@ main() {
|
|||
mkdir -p release-packages
|
||||
|
||||
release_archive
|
||||
if [[ $OS == linux && $ARCH == "amd64" ]]; then
|
||||
# Will stop most of the auto update issues.
|
||||
# For the other releases it's more important to not pollute the release listing.
|
||||
ARCH=x86_64 release_archive
|
||||
# Will stop the auto update issues and allow people to upgrade their scripts
|
||||
# for the new release structure.
|
||||
if [[ $ARCH == "amd64" ]]; then
|
||||
if [[ $OS == "linux" ]]; then
|
||||
ARCH=x86_64 release_archive
|
||||
elif [[ $OS == "macos" ]]; then
|
||||
OS=darwin ARCH=x86_64 release_archive
|
||||
fi
|
||||
fi
|
||||
|
||||
if [[ $OSTYPE == linux* ]]; then
|
||||
|
|
|
@ -17,9 +17,9 @@ bin_dir() {
|
|||
}
|
||||
|
||||
BIN_DIR=$(bin_dir)
|
||||
if [ "$(uname)" = "Linux"]; then
|
||||
if [ "$(uname)" = "Linux" ]; then
|
||||
export LD_LIBRARY_PATH="$BIN_DIR/../lib${LD_LIBRARY_PATH+:$LD_LIBRARY_PATH}"
|
||||
else
|
||||
export DYLD_LIBRARY_PATH="$BIN_DIR/../lib${LD_LIBRARY_PATH+:$LD_LIBRARY_PATH}"
|
||||
export DYLD_LIBRARY_PATH="$BIN_DIR/../lib${DYLD_LIBRARY_PATH+:$DYLD_LIBRARY_PATH}"
|
||||
fi
|
||||
exec "$BIN_DIR/../lib/node" "$BIN_DIR/.." "$@"
|
||||
|
|
|
@ -19,6 +19,7 @@
|
|||
- [Heartbeat File](#heartbeat-file)
|
||||
- [How does the config file work?](#how-does-the-config-file-work)
|
||||
- [Blank screen on iPad?](#blank-screen-on-ipad)
|
||||
- [Isn't an install script insecure?](#isnt-an-install-script-insecure)
|
||||
- [Enterprise](#enterprise)
|
||||
|
||||
<!-- END doctoc generated TOC please keep comment here to allow auto update -->
|
||||
|
@ -242,6 +243,12 @@ certificate using the CA and then import the CA onto your iPad.
|
|||
|
||||
See [#1566](https://github.com/cdr/code-server/issues/1566#issuecomment-623159434).
|
||||
|
||||
## Isn't an install script insecure?
|
||||
|
||||
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.
|
||||
|
||||
## Enterprise
|
||||
|
||||
Visit [our enterprise page](https://coder.com) for more information about our
|
||||
|
|
|
@ -77,7 +77,8 @@ to avoid the slow dashboard.
|
|||
|
||||
## 2. Install code-server
|
||||
|
||||
We have a script to install code-server on Linux or macOS preferring to use the system package manager.
|
||||
[We have a script](./install.sh) to install code-server for Linux or macOS.
|
||||
It tries to use the system package manager if possible.
|
||||
|
||||
First run to print out the install process:
|
||||
|
||||
|
@ -91,7 +92,9 @@ Now to actually install:
|
|||
curl -fsSL https://code-server.dev/install.sh | sh
|
||||
```
|
||||
|
||||
Docs on the install script, manual installation and docker instructions are at [./doc/install.md](./doc/install.md).
|
||||
The install script will print out how to run and start using code-server.
|
||||
|
||||
Docs on the install script, manual installation and docker image are at [./doc/install.md](./doc/install.md).
|
||||
|
||||
## 3. Expose code-server
|
||||
|
||||
|
|
|
@ -16,17 +16,10 @@
|
|||
This document demonstrates how to install `code-server` on
|
||||
various distros and operating systems.
|
||||
|
||||
The steps in this document are exactly what the install script does.
|
||||
|
||||
We recommend using the install script if possible. You can run
|
||||
the install script with the `--dry-run` flag for a dry run which will
|
||||
print out the commands it will run to install `code-server` but
|
||||
not run anything. That way you can verify the script is functioning
|
||||
as intended before installing.
|
||||
|
||||
## install.sh
|
||||
|
||||
We have a script to install code-server on Linux or macOS preferring to use the system package manager.
|
||||
[We have a script](./install.sh) to install code-server for Linux or macOS.
|
||||
It tries to use the system package manager if possible.
|
||||
|
||||
First run to print out the install process:
|
||||
|
||||
|
@ -40,28 +33,40 @@ Now to actually install:
|
|||
curl -fsSL https://code-server.dev/install.sh | sh
|
||||
```
|
||||
|
||||
- For Debian, Ubuntu, Raspbian it will install the latest deb package.
|
||||
- For Fedora, CentOS, RHEL, openSUSE it will install the latest rpm package.
|
||||
- For Arch Linux it will install the AUR package.
|
||||
- For any unrecognized Linux operating system it will install the latest static release into ~/.local
|
||||
The script will print out how to run and start using code-server.
|
||||
|
||||
- Add ~/.local/bin to your \$PATH to run code-server.
|
||||
- For Debian, Ubuntu and Raspbian it will install the latest deb package.
|
||||
- For Fedora, CentOS, RHEL and openSUSE it will install the latest rpm package.
|
||||
- For Arch Linux it will install the AUR package.
|
||||
- For any unrecognized Linux operating system it will install the latest static release into `~/.local`
|
||||
|
||||
- Add `~/.local/bin` to your `$PATH` to run code-server.
|
||||
|
||||
- For macOS it will install the Homebrew package.
|
||||
|
||||
- If Homebrew is not installed it will install the latest static release into ~/.local
|
||||
- If Homebrew is not installed it will install the latest static release into `~/.local`
|
||||
- Add ~/.local/bin to your \$PATH to run code-server.
|
||||
|
||||
- If ran on an architecture with no binary releases, it will install the npm package with yarn or npm.
|
||||
- If ran on an architecture with no binary releases, it will install the npm package with `yarn` or `npm`.
|
||||
- We only have binary releases for amd64 and arm64 presently.
|
||||
|
||||
Pass `--dry-run` to echo the commands for the install process without running them.
|
||||
|
||||
Pass `--static` to install a static release into `~/.local`.
|
||||
|
||||
Pass `--static=/usr/local` to install a static release system wide.
|
||||
|
||||
Pass `--version=X.X.X` to install version `X.X.X` instead of latest.
|
||||
|
||||
If you still don't trust our install script, even with the above explaination and the dry run,
|
||||
continue for docs on manual installation. The script runs the exact same commands depicted
|
||||
in the rest of this document.
|
||||
Pass `--help` to see full usage docs.
|
||||
|
||||
If you believe an install script used via curl is insecure, 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.
|
||||
|
||||
If you'd still prefer manual installation despite the above explanations and `--dry-run`
|
||||
then continue for docs on manual installation. The [`install.sh`](./install.sh) script runs the *exact* same
|
||||
commands depicted in the rest of this document.
|
||||
|
||||
## Debian, Ubuntu
|
||||
|
||||
|
|
34
install.sh
34
install.sh
|
@ -17,38 +17,44 @@ EOF
|
|||
"
|
||||
fi
|
||||
cat << EOF
|
||||
Installs the latest code-server on Linux or macOS preferring to use the system package manager.
|
||||
Installs code-server for Linux or macOS.
|
||||
It tries to use the system package manager if possible.
|
||||
After successful installation it explains how to start using code-server.
|
||||
|
||||
Usage:
|
||||
|
||||
$cli [--dry-run] [--version X.X.X] [--static <install-prefix>=~/.local]
|
||||
${curl_usage-}
|
||||
- For Debian, Ubuntu, Raspbian it will install the latest deb package.
|
||||
- For Fedora, CentOS, RHEL, openSUSE it will install the latest rpm package.
|
||||
- For Debian, Ubuntu and Raspbian it will install the latest deb package.
|
||||
- For Fedora, CentOS, RHEL and openSUSE it will install the latest rpm package.
|
||||
- For Arch Linux it will install the AUR package.
|
||||
- For any unrecognized Linux operating system it will install the latest static release into ~/.local
|
||||
- For any unrecognized Linux operating system it will install the latest static
|
||||
release into ~/.local
|
||||
- Add ~/.local/bin to your \$PATH to run code-server.
|
||||
|
||||
- For macOS it will install the Homebrew package.
|
||||
- If Homebrew is not installed it will install the latest static release into ~/.local
|
||||
- If Homebrew is not installed it will install the latest static release
|
||||
into ~/.local
|
||||
- Add ~/.local/bin to your \$PATH to run code-server.
|
||||
|
||||
- If ran on an architecture with no binary releases, it will install the npm package with yarn or npm.
|
||||
- If ran on an architecture with no binary releases, it will install the
|
||||
npm package with yarn or npm.
|
||||
- We only have binary releases for amd64 and arm64 presently.
|
||||
|
||||
--dry-run Enables a dry run where where the steps that would have taken place
|
||||
are printed but do not actually execute.
|
||||
--dry-run Echo the commands for the install process without running them.
|
||||
|
||||
--version Pass to install a specific version instead of the latest release.
|
||||
--version Install a specific version instead of the latest release.
|
||||
|
||||
--static Forces the installation of a static release into ~/.local
|
||||
--static Install a static release into ~/.local
|
||||
|
||||
This flag takes an optional argument for the installation prefix which defaults to "~/.local".
|
||||
code-server will be unarchived into ~/.local/lib/code-server.X.X.X and the binary will be symlinked
|
||||
into "~/.local/bin/code-server". You will need to add ~/.local/bin to your \$PATH to use it without
|
||||
code-server will be unarchived into ~/.local/lib/code-server.X.X.X
|
||||
and the binary will be symlinked into ~/.local/bin/code-server.
|
||||
You will need to add ~/.local/bin to your \$PATH to use it without
|
||||
the full path.
|
||||
|
||||
To install system wide set the prefix to /usr/local.
|
||||
|
||||
https://github.com/cdr/code-server/blob/master/doc/install.md
|
||||
EOF
|
||||
}
|
||||
|
||||
|
@ -63,6 +69,7 @@ echo_static_postinstall() {
|
|||
echo
|
||||
cat << EOF
|
||||
Static release has been installed into $STATIC_INSTALL_PREFIX/lib/code-server-$VERSION
|
||||
|
||||
Please extend your path to use code-server:
|
||||
PATH="$STATIC_INSTALL_PREFIX/bin:\$PATH"
|
||||
Then you can run:
|
||||
|
@ -176,7 +183,6 @@ main() {
|
|||
*)
|
||||
install_static
|
||||
;;
|
||||
|
||||
esac
|
||||
}
|
||||
|
||||
|
|
Loading…
Reference in New Issue