- Manuals by Crouton developer David Schneider on GitHub
- Manuals from Ubuntu site
- Various simplified install intros:
- What to do after install by Andrew
What Chrome OS channel is running on a Chromebook is not essentail for the Crouton install. However, it can become important later since things may be less stable if the developer channel is running. The Chrome OS channel can be checked and changed as follows: go to settings under Chrome OS (bottom right corner of main screen) -> select menu in the top left corner -> about Chrome OS -> detailed build information -> change channel. The resulting change channel window shows which channel is currently active. For more details see here.
Note this will erase all local data. So back things up first. Instructions for enabling developer mode are here, and the details for specific Chromebooks are given here.
For better integraton with Chrome OS install Crouton Integraton extension. It is needed to run crouton within a Chrome OS session rather than in parallel.
-
Download latest Crouton release from here https://goo.gl/fd3zc which comes form developer's repository here. For simplicity leave downloaded
crouton
file in Downloads folder. Note, as of April 2019 there may be changes to this approach due to security updates in Chrome. Here are some updates. -
Open in Chrome browser crosh shell with
CTRL + ALT + T
and then typeshell
-
Now install crouton for the proper linux release specified under
-r
argument (xenial is the Ubuntu 16.04) along with proper targets. The latter are selected under the-t
argument. The names and other details about Ubuntu releases can be looked up on this Ubuntu site. The chroot name can be specified with the-n
option (default is name of chosen release, e.g. xenial). If the-e
argument is added then the chroot will be encrypted.sudo sh ~/Downloads/crouton -r xenial -t x11,chrome,xorg,xiwi,keyboard,touch,unity,xfce -e # These are your most current targets; in the past you used unity,xfce,xiwi,keyboard,touch
Enter chroot from crosh shell
sudo enter-chroot
List targets installed in a chroot
sudo edit-chroot -al # Execute in Chrome OS after Ctrl+alt+t and then shell
List available linux releases
sh ~/Downloads/crouton -r list
List all available targets
sh ~/Downloads/crouton -t help
Add target to an existing chroot with -u
option
sudo sh ~/Downloads/crouton -t xiwi -u -n xenial
Location of chroots
ls -al /usr/local/chroots/
Run chroot in same Chrome OS session. This requires the Crouton Integraton extension (see above) along with the xiwi target.
sudo startxfce4 -X xiwi
or run in parallel mode
sudo startxfce4 or startunity # shortcuts for enter-chroot startxfce4
To switch between chroot and ChromeOS use Ctrl+Alt+Shift+Back
and Ctrl+Alt+Shift+Forward
; or Alt+Tab
when in same session.
To shutdown choot, log out or shut down on the Ubuntu side as usual or issue Ctrl+c
in crosh tab where you started chroot session.
Check if there is a newer crouton version, run on Ubuntu side:
croutonversion -u -c # list installed and latest available version
Then shutdown Ubuntu and run in crosh shell the following command. This will update/upgrade all installed targets.
sudo sh ~/Downloads/crouton -u -n xenial
Currently, it is not easily possible to delete targets due to complicated interdendencies/histories of packages across targets!!!
To remove a chroot, one can use the following command(s).
sudo delete-chroot <my_chroot>
# sudo edit-chroot -d <my_choot> # Does the same; delete-chroot is just a shortcut
Back up your chroot to a timestamped tarball in the current directory.
sudo edit-chroot -b xenial
Restore chroot from the most recent timestamped tarball. One can explicitly specify the tarball with -f.
sudo edit-chroot -r chrootname
If your machine is new or powerwashed, one can use the crouton installer to restore a chroot and relevant scripts.
sudo sh ~/Downloads/crouton -f mybackup.tar.gz
Within a Chroot one should update and install software packages via apt
or apt-get
, see example below. Detailed instructions for using apt
or apt-get
are available on Ubuntu's AptGet/Howto. Installing software via Ubuntu's Software manager should be avoided since it creates often problems. The GDebi Package installer seems to work fine as an alternative.
sudo apt update && sudo apt install <my_software>
If apt update
and/or apt install
are not working then try the follwing troubleshooting steps. Additional help on this topic can be found here.
The autoclean
command might fix the problem. Sometimes it may only work in a freshly started chroot session. So try restarting it if it fails, or start temporarily a chroot from crosh shell within a chrome browser tab with sudo enter-chroot
, and then run update/install from there.
sudo apt clean && sudo apt autoclean # This might fix things
sudo apt update # or with && sudo apt upgrade
After running update
also try this
sudo apt -f install
Another reason could be a broken dpkg system. To fix this, run the following commands.
sudo dpkg --configure -a
sudo apt upgrade
sudo apt update
Reinstalling libcurl3-gnutls
has also been reported to help.
sudo apt --reinstall install libcurl3-gnutls
There are also reports that using more RAM on the Chrome OS side might help. For this just open a few data/process intensive tabs in Chrome. Also check if there are any broken PPAs in /etc/apt/sources.list.d
.
Is there any way to do it without switching to developer mode 😩 ?
-Newton Triumphant