Skip to content

Commit ad82916

Browse files
committed
Update README again to improve the structure of sections.
1 parent b08b088 commit ad82916

File tree

1 file changed

+17
-21
lines changed

1 file changed

+17
-21
lines changed

README.md

Lines changed: 17 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,17 @@
11
# chromeos-build
2-
A tool to build Chrome OS easily
2+
Scripts to build Chrome OS easily
33

4-
## Prerequisites
4+
## How to run Chromium OS on KVM
5+
6+
Retrieve one of KVM images. I recommend [chromiumos_qemu_image-R60-9592.63-amd64-generic.32GB.qcow2.xz](https://github.com/jam7/chromeos-build/releases/download/R60/chromiumos_qemu_image-R60-9592.63-amd64-generic.32GB.qcow2.xz), 410MB.
7+
8+
Then, create VM using the image. [Here](https://www.chromium.org/chromium-os/how-tos-and-troubleshooting/running-chromeos-image-under-virtual-machines) has command line for KVM. If you use GUI manager, plase make sure to use **cirrius** VGA and **SATA** or **IDE** storage device.
9+
10+
You cannot log in from GUI until you register your own google API keys, but it is possible to ssh to Chromium OS with chronos:chronos account.
11+
12+
## How to compile Chromium OS by yourself
13+
14+
### Prerequisites
515
Prerequisites are described [here](https://www.chromium.org/chromium-os/developer-guide).
616

717
I'll list them for the ease. **Bold** means new or different prerequisities from above. I noticed them through my experience.
@@ -14,16 +24,6 @@ I'll list them for the ease. **Bold** means new or different prerequisities fro
1424
- configure git
1525
- tweak sudoers for **400** minutes (My machine takes more than 180 min for compilation)
1626

17-
## How to run Chromium OS on KVM
18-
19-
Retrieve one of KVM images. I recommend [chromiumos_image-R60-9592.63-amd64-generic.bin.xz](https://github.com/jam7/chromeos-build/releases/download/R60/chromiumos_image-R60-9592.63-amd64-generic.bin.xz).
20-
21-
Then, create VM using the image. It is required to use **cirrius** VGA and **SATA** or **IDE** storage.
22-
23-
You cannot log in from GUI until you register your own google API keys, but it is possible to ssh to Chromium OS with chronos:chronos account.
24-
25-
## How to compile Chromium OS by yourself
26-
2727
### Setup
2828
Type following command to prepare depo_tools and sources.
2929

@@ -59,11 +59,7 @@ Convert qemu raw image to qcow2 image if your qemu-manager requires it.
5959
$ qemu-img convert -f raw -O qcow2 chromiumos_qemu_image-R55-8872.76-amd64-generic.img chromiumos_qemu_image-R55-8872.76-amd64-generic.qcow2
6060
```
6161

62-
## How to run Chromium OS on KVM
63-
64-
Create VM using GUI manager. It is required to use **cirrius** VGA. At this time, you cannot log in from GUI since google API keys are not installed yet.
65-
66-
## How to set chronos password
62+
## How to change chronos password
6763

6864
Push `CTRL`+`ALT`+`F2`. Type `chronos` as a user. You may need to enter `chronos` as password also.
6965

@@ -78,11 +74,11 @@ Retype new UNIX password:
7874
passwd: password updated successfully
7975
```
8076

81-
After updating UNIX password, you can ssh to Chromium OS.
77+
It is required to update UNIX password to log-in through ssh.
8278

8379
## How to set google API keys
8480

85-
You need to retrieve your own API keys from https://www.chromium.org/developers/how-tos/api-keys. Then, you can update Chromium OS like below.
81+
You need to retrieve your own API keys from https://www.chromium.org/developers/how-tos/api-keys. Then, you can set those API keys into Chromium OS like below.
8682

8783
```
8884
$ sudo mount -o remount,rw /
@@ -93,9 +89,9 @@ GOOGLE_DEFAULT_CLIENT_ID=your_client_id
9389
GOOGLE_DEFAULT_CLIENT_SECRET=your_client_secret
9490
```
9591

96-
Now, you need to reboot Chromium OS once. Push `CTRL`+`ALT`+`F1` to switch back to GUI and click `Shut down` button.
92+
You need to reboot Chromium OS once.
9793

98-
## How to disable suspend
94+
## How to disable sleep
9995

10096
```
10197
$ sudo bash -c 'echo 1 >/var/lib/power_manager/disable_idle_suspend'

0 commit comments

Comments
 (0)