2019-08-17 03:46:37 +08:00
|
|
|
# Installng code-server on a ChromeOS/CloudReady machine
|
2019-03-20 22:24:07 +08:00
|
|
|
|
2019-08-17 03:46:37 +08:00
|
|
|
This guide will show you how to install code-server on your CrOS machine.
|
2019-03-20 22:24:07 +08:00
|
|
|
|
|
|
|
|
## Using Crostini
|
|
|
|
|
|
2019-08-17 03:46:37 +08:00
|
|
|
One of the easier ways to run code-server is via [Crostini](crostini), the Linux
|
|
|
|
|
apps support feature in CrOS. Make sure you have enough RAM, HDD space and your
|
|
|
|
|
CPU has VT-x/AMD-V support. If your Chromebook has this, then you are qualified
|
|
|
|
|
to use Crostini.
|
2019-03-20 22:24:07 +08:00
|
|
|
|
2019-08-17 03:46:37 +08:00
|
|
|
If you are running R69, you might want to enable this on
|
|
|
|
|
[Chrome Flags](r69-flag). If you run R72, however, this is already enabled for
|
|
|
|
|
you.
|
2019-03-20 22:24:07 +08:00
|
|
|
|
2019-08-17 03:46:37 +08:00
|
|
|
After checking your prerequisites, follow the steps in [the self-host install
|
|
|
|
|
guide](self-hosted-guide) on installing code-server. Once done, make sure
|
|
|
|
|
code-server works by running it, then simply go to `penguin.linux.test:8443` to
|
|
|
|
|
access code-server. You should be greeted with the following screen. If it
|
|
|
|
|
works, congratulations, you have installed code-server in your Chromebook!
|
2019-03-20 22:24:07 +08:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2019-08-17 03:46:37 +08:00
|
|
|
Alternatively, if you ran code-server in another container and you need the IP
|
|
|
|
|
for that specific container, simply go to Termina's shell via `crosh` and type
|
|
|
|
|
`vsh termina`.
|
2019-03-20 22:24:07 +08:00
|
|
|
|
2019-08-17 03:46:37 +08:00
|
|
|
```
|
2019-03-20 22:24:07 +08:00
|
|
|
Loading extra module: /usr/share/crosh/dev.d/50-crosh.sh
|
|
|
|
|
Welcome to crosh, the Chrome OS developer shell.
|
|
|
|
|
|
|
|
|
|
If you got here by mistake, don't panic! Just close this tab and carry on.
|
|
|
|
|
|
|
|
|
|
Type 'help' for a list of commands.
|
|
|
|
|
|
|
|
|
|
If you want to customize the look/behavior, you can use the options page.
|
|
|
|
|
Load it by using the Ctrl+Shift+P keyboard shortcut.
|
|
|
|
|
|
|
|
|
|
crosh> vsh termina
|
|
|
|
|
(termina) chronos@localhost ~ $
|
|
|
|
|
```
|
|
|
|
|
|
2019-08-17 03:46:37 +08:00
|
|
|
While in termina, run `lxc list`. It should output the list of running
|
|
|
|
|
containers.
|
|
|
|
|
|
|
|
|
|
```
|
2019-03-20 22:24:07 +08:00
|
|
|
(termina) chronos@localhost ~ $ lxc list
|
|
|
|
|
+---------+---------+-----------------------+------+------------+-----------+
|
|
|
|
|
| NAME | STATE | IPV4 | IPV6 | TYPE | SNAPSHOTS |
|
|
|
|
|
+---------+---------+-----------------------+------+------------+-----------+
|
|
|
|
|
| penguin | RUNNING | 100.115.92.199 (eth0) | | PERSISTENT | 0 |
|
|
|
|
|
+---------+---------+-----------------------+------+------------+-----------+
|
2019-08-19 19:12:04 +08:00
|
|
|
(termina) chronos@localhost ~ $
|
2019-03-20 22:24:07 +08:00
|
|
|
```
|
|
|
|
|
|
2019-08-17 03:46:37 +08:00
|
|
|
For this example, we show the default `penguin` container, which is exposed on
|
|
|
|
|
`eth0` at 100.115.92.199. Simply enter the IP of the container where code-server
|
|
|
|
|
is running into Chrome to access code-server.
|
|
|
|
|
|
|
|
|
|
[crostini]: https://www.aboutchromebooks.com/tag/project-crostini/
|
|
|
|
|
[r69-flag]: chrome://flags/#enable-experimental-crostini-ui
|
|
|
|
|
[self-hosted-guide]: ./index.md
|
2019-03-20 22:24:07 +08:00
|
|
|
|
|
|
|
|
## Using Crouton
|
|
|
|
|
|
2019-08-17 03:46:37 +08:00
|
|
|
[Crouton](crouton) is one of the old ways to get a running full Linux via
|
|
|
|
|
`chroot` on a Chromebook. To use crouton, enable developer mode and go to
|
|
|
|
|
`crosh`. This time, run `shell`, which should drop you to `bash`.
|
|
|
|
|
|
|
|
|
|
Make sure you downloaded `crouton`, if so, go ahead and run it under
|
|
|
|
|
`~/Downloads`. After installing your chroot container via crouton, go ahead and
|
|
|
|
|
enter `enter-chroot` to enter your container.
|
2019-03-20 22:24:07 +08:00
|
|
|
|
2019-08-17 03:46:37 +08:00
|
|
|
Follow the instructions set in [the self-host install guide](self-hosted-guide)
|
|
|
|
|
to install code-server. After that is done, run `code-server` and verify it
|
|
|
|
|
works by going to `localhost:8443`.
|
2019-03-20 22:24:07 +08:00
|
|
|
|
2019-08-17 03:46:37 +08:00
|
|
|
> At this point in writing, `localhost` seems to work in this method. However,
|
|
|
|
|
> it might not apply to newer Chromebooks.
|
2019-03-20 22:24:07 +08:00
|
|
|
|
2019-08-17 03:46:37 +08:00
|
|
|
[crouton]: https://github.com/dnschneid/crouton
|
