GalliumOS Wiki - User contributions [en]

Installing

2018-05-29T22:46:25Z

Nbastin:

== General Install Instructions ==
You have two possible options for installing GalliumOS:
# '''From an ISO image on a USB drive or SD card''' This method enables you to entirely replace ChromeOS on your internal SSD or HDD. It also allows you to set up more complex configurations such as dual-booting alongside Windows or other Linux distributions.
# '''From the ChromeOS command-line using chrx''' This method will configure your device to dual-boot GalliumOS alongside ChromeOS.

See [[Hardware Compatibility]] for the installation options available for your ChromeOS device model.

=== Traditional ISO Install ===

The traditional installer allows you to use your entire SSD or HDD for GalliumOS. You will need to use a USB flash drive or SD card. You can even boot the GalliumOS Live image to try out the features of GalliumOS before you decide to install!

# Go to [[Installing/Preparing]] and get your Chromebook ready to run GalliumOS
# [https://galliumos.org/download Download] the appropriate GalliumOS ISO for your device
# Write (or "burn") the ISO to a USB flash drive or an SD card
#* Detailed instructions at [[Installing/Creating Bootable USB]]
# Plug your USB flash drive or SD card into your Chromebook
# Reboot your Chromebook and boot from the USB flash drive or SD card
#* If you have the white "OS verification is OFF" screen, press <code>Ctrl</code>+<code>L</code>
#* If you have installed custom firmware, press Esc at the BIOS screen and select the USB device
# Wait for GalliumOS to boot up. Once in the live environment you can play around with GalliumOS, or you can install it using the Install GalliumOS icon on the desktop
# After reboot, press <code>Ctrl</code>+<code>L</code> to access GalliumOS (this requirement can be bypassed for single-boot on most models, see [[Firmware]])

'''Important:''' If you choose an ISO install of GalliumOS (thus removing ChromeOS), and choose to use the Legacy Boot Mode of the stock firmware (ie, with the stock or updated RW_LEGACY firmware), and you allow your battery to drain completely, you might have a problem booting GalliumOS. This is due to the Developer Mode boot flag enabling Legacy Boot mode being reset when power is lost - see [https://wiki.galliumos.org/Firmware#crossystem crossystem flags].

This is easily fixable, but it's preferable to avoid the issue entirely by either setting the corresponding firmware boot flag (which is not reset when power is lost), or by flashing custom Full ROM firmware - see [[Firmware]]

=== chrx Installation ===

Installing GalliumOS via [https://chrx.org/ chrx] allows you to dual-boot GalliumOS alongside ChromeOS. Check the [https://chrx.org/#compatibility chrx hardware compatibility list] to see if your device supports chrx, and whether any preparation steps are required.

See [https://chrx.org#usage chrx installation instructions] for full details, but here's a quick overview:

# Prepare your ChromeOS device: see [[Installing/Preparing]]
# Boot device into ChromeOS and configure networking; you do not need to log in
# Switch to a virtual terminal by pressing <code>Ctrl</code>+<code>Alt</code>+<code>F2(top row right arrow)</code>, then log in as user <code>chronos</code> with no password
# Run chrx: <code>cd ; curl -O <nowiki>https://chrx.org/go</nowiki> && sh go</code> (see [https://chrx.org/#options chrx docs] for additional options)
# Follow on-screen prompts to repartition your SSD and install GalliumOS. If this is the first time running chrx on this ChromeOS machine, chrx will reboot after the partitioning step and you will need to continue the installation by running chrx again with the same command line.
# After reboot, at the white "OS verification is OFF" screen, press <code>Ctrl</code>+<code>L</code> for GalliumOS, or <code>Ctrl</code>+<code>D</code> for ChromeOS

== Additional Software ==
[[Additional_Software|Additional Software for GalliumOS]]

== Developer Installation ==

You can install GalliumOS as a virtual machine in order to do user-space software development and testing. Obviously hardware-specific issues will not be debuggable in these environments.

* [[Installing/VirtualBox | VirtualBox]]
* [[Installing/VMWareFusion | VMWare (Fusion)]]

Installing/VMWareFusion

2018-05-29T06:44:43Z

Nbastin:

= Installing in VMWare Fusion Pro =

''Note: These instructions were written for the current 3.0 nightly builds, and Fusion Pro 10. Existing 2.1 builds (and future 3.0 production builds) should work with Fusion Pro 8 with similar configuration changes for the hard drive.''

The first step is to download the ''Haswell'' installation ISO from the [https://galliumos.org/releases/nightly/ GalliumOS nightly release site].

== Configure VMWare Machine ==

=== Basic Setup ===

* Select the option to make a new VM from the toolbar
* Choose the default '''Install from disc or image''' and click '''Continue'''
* Click the '''Use another disc or disc image...''' button and locate the ISO you have downloaded
* Make sure the ISO you imported is selected, and click '''Continue'''
* Scroll down in the right pane of the ''Operating System'' dialog and choose '''Other Linux 4.x or later kernel 64-bit'''
* Change the boot firmware to '''UEFI''' and click '''Continue'''

[[File:firmware.png]]

''Note: You can use '''Legacy BIOS''' here, but using '''UEFI''' will generally lead to a better experience and will allow for screen resizing without having to manually install VMWare Tools''

* Click the '''Customize Settings''' button on the ''Final'' screen and save the VM config

=== Settings Changes ===

* Click the '''Processors & Memory''' button and change the memory and CPU to your desired values, and click '''Show All''' to return to the settings pane
* Click the '''Hard Disk''' button
* Click the disclosure arrow next to '''Advanced options''' and change the '''Bus type''' to ''SATA''

[[File:hdd-sata.png]]

* Click the '''Apply''' button and then click '''Show All''' to return to the settings pane
* Click the '''CD/DVD''' button
* Click the disclosure arrow next to '''Advanced options''' and change the '''Bus type''' to ''SATA''

[[File:cd-sata.png]]

* You can now close all the settings, or configure other devices as you prefer (camera, bluetooth, etc.).

=== Boot the Installer ===

* Click in the VM window to boot your virtual machine
* Once the VM is booted, you will not have any network connectivity on your emulated ethernet interface
* Open up a terminal window using the toolbar at the bottom left of your screen:

[[File:terminal-arrow.png]]

* Run the ''ip link'' command to figure out the name of your ethernet interface (it is likely ''ens33'', but you should check):

[[File:iplink.png]]

* Taking that interface name, now run ''dhclient'' to get connected:

[[File:dhclient.png]]

* You can now close that window and double click on the '''Install GalliumOS 3.0''' icon in the upper left of the desktop

The installer will walk you through the installation - choose the options that make the most sense for your environment. The defaults are fine unless you need to change your language, keyboard layout, or time zone.

The installer will automatically eject the install media at the end of installation when you reboot the VM. You will need to hit ''Enter'' to proceed into your next boot after the install is completed and you have clicked the '''Restart''' button

=== Networking Fix ===

You have now booted into a (mostly) working GalliumOS!

Your networking still will not be working by default:

[[File:nonet.png]]

To fix this problem, open a Terminal, and execute the following commands:

* <pre>sudo touch /etc/NetworkManager/conf.d/10-globally-managed-devices.conf</pre>
* <pre>sudo service NetworkManager restart</pre>

[[File:fixnet.png]]

You will now have a working network, properly indicated in the UI:

[[File:withnet.png]]

Installing/VMWareFusion

2018-05-29T06:43:40Z

Nbastin:

= Installing in VMWare Fusion Pro =

''Note: These instructions were written for the current 3.0 nightly builds, and Fusion Pro 10. Existing 2.1 builds (and future 3.0 production builds) should work with Fusion Pro 8 with similar configuration changes for the hard drive.''

The first step is to download the ''Haswell'' installation ISO from the [https://galliumos.org/releases/nightly/ GalliumOS nightly release site].

== Configure VMWare Machine ==

=== Basic Setup ===

* Select the option to make a new VM from the toolbar
* Choose the default '''Install from disc or image''' and click '''Continue'''
* Click the '''Use another disc or disc image...''' button and locate the ISO you have downloaded
* Make sure the ISO you imported is selected, and click '''Continue'''
* Scroll down in the right pane of the ''Operating System'' dialog and choose '''Other Linux 4.x or later kernel 64-bit'''
* Change the boot firmware to '''UEFI''' and click '''Continue'''

[[File:firmware.png]]

''Note: You can use '''Legacy BIOS''' here, but using '''UEFI''' will generally lead to a better experience and will allow for screen resizing without having to manually install VMWare Tools''

* Click the '''Customize Settings''' button on the ''Final'' screen and save the VM config

=== Settings Changes ===

* Click the '''Processors & Memory''' button and change the memory and CPU to your desired values, and click '''Show All''' to return to the settings pane
* Click the '''Hard Disk''' button
* Click the disclosure arrow next to '''Advanced options''' and change the '''Bus type''' to ''SATA''

[[File:hdd-sata.png]]

* Click the '''Apply''' button and then click '''Show All''' to return to the settings pane
* Click the '''CD/DVD''' button
* Click the disclosure arrow next to '''Advanced options''' and change the '''Bus type''' to ''SATA''

[[File:cd-sata.png]]

* You can now close all the settings, or configure other devices as you prefer (camera, bluetooth, etc.).

=== Boot the Installer ===

* Click in the VM window to boot your virtual machine
* Once the VM is booted, you will not have any network connectivity on your emulated ethernet interface
* Open up a terminal window using the toolbar at the bottom left of your screen:

[[File:terminal-arrow.png]]

* Run the ''ip link'' command to figure out the name of your ethernet interface (it is likely ''ens33'', but you should check):

[[File:iplink.png]]

* Taking that interface name, now run ''dhclient'' to get connected:

[[File:dhclient.png]]

* You can now close that window and double click on the '''Install GalliumOS 3.0''' icon in the upper left of the desktop
* Follow the prompts and configure as desired

After the installation is complete, the system will reboot and pause for you to eject the installation media. This has already happened, so just hit '''Enter''' to continue.

=== Networking Fix ===

You have now booted into a (mostly) working GalliumOS!

Your networking still will not be working by default:

[[File:nonet.png]]

To fix this problem, open a Terminal, and execute the following commands:

* <pre>sudo touch /etc/NetworkManager/conf.d/10-globally-managed-devices.conf</pre>
* <pre>sudo service NetworkManager restart</pre>

[[File:fixnet.png]]

You will now have a working network, properly indicated in the UI:

[[File:withnet.png]]

File:Withnet.png

2018-05-29T06:43:37Z

Nbastin:

File:Fixnet.png

2018-05-29T06:43:23Z

Nbastin:

File:Nonet.png

2018-05-29T06:42:54Z

Nbastin:

File:Dhclient.png

2018-05-29T06:37:18Z

Nbastin:

File:Iplink.png

2018-05-29T06:37:02Z

Nbastin:

File:Terminal-arrow.png

2018-05-29T06:36:44Z

Nbastin:

Installing/VMWareFusion

2018-05-29T06:28:35Z

Nbastin: Created page with "= Installing in VMWare Fusion Pro = ''Note: These instructions were written for the current 3.0 nightly builds, and Fusion Pro 10. Existing 2.1 builds (and future 3.0 produc..."

File:Cd-sata.png

2018-05-29T06:28:07Z

Nbastin:

File:Hdd-sata.png

2018-05-29T06:25:39Z

Nbastin:

File:Firmware.png

2018-05-29T06:16:41Z

Nbastin:

Installing

2018-05-28T07:06:29Z

Nbastin:

== General Install Instructions ==
You have two possible options for installing GalliumOS:
# '''From an ISO image on a USB drive or SD card''' This method enables you to entirely replace ChromeOS on your internal SSD or HDD. It also allows you to set up more complex configurations such as dual-booting alongside Windows or other Linux distributions.
# '''From the ChromeOS command-line using chrx''' This method will configure your device to dual-boot GalliumOS alongside ChromeOS.

See [[Hardware Compatibility]] for the installation options available for your ChromeOS device model.

=== Traditional ISO Install ===

The traditional installer allows you to use your entire SSD or HDD for GalliumOS. You will need to use a USB flash drive or SD card. You can even boot the GalliumOS Live image to try out the features of GalliumOS before you decide to install!

# Go to [[Installing/Preparing]] and get your Chromebook ready to run GalliumOS
# [https://galliumos.org/download Download] the appropriate GalliumOS ISO for your device
# Write (or "burn") the ISO to a USB flash drive or an SD card
#* Detailed instructions at [[Installing/Creating Bootable USB]]
# Plug your USB flash drive or SD card into your Chromebook
# Reboot your Chromebook and boot from the USB flash drive or SD card
#* If you have the white "OS verification is OFF" screen, press <code>Ctrl</code>+<code>L</code>
#* If you have installed custom firmware, press Esc at the BIOS screen and select the USB device
# Wait for GalliumOS to boot up. Once in the live environment you can play around with GalliumOS, or you can install it using the Install GalliumOS icon on the desktop
# After reboot, press <code>Ctrl</code>+<code>L</code> to access GalliumOS (this requirement can be bypassed for single-boot on most models, see [[Firmware]])

'''Important:''' If you choose an ISO install of GalliumOS (thus removing ChromeOS), and choose to use the Legacy Boot Mode of the stock firmware (ie, with the stock or updated RW_LEGACY firmware), and you allow your battery to drain completely, you might have a problem booting GalliumOS. This is due to the Developer Mode boot flag enabling Legacy Boot mode being reset when power is lost - see [https://wiki.galliumos.org/Firmware#crossystem crossystem flags].

This is easily fixable, but it's preferable to avoid the issue entirely by either setting the corresponding firmware boot flag (which is not reset when power is lost), or by flashing custom Full ROM firmware - see [[Firmware]]

=== chrx Installation ===

Installing GalliumOS via [https://chrx.org/ chrx] allows you to dual-boot GalliumOS alongside ChromeOS. Check the [https://chrx.org/#compatibility chrx hardware compatibility list] to see if your device supports chrx, and whether any preparation steps are required.

See [https://chrx.org#usage chrx installation instructions] for full details, but here's a quick overview:

# Prepare your ChromeOS device: see [[Installing/Preparing]]
# Boot device into ChromeOS and configure networking; you do not need to log in
# Switch to a virtual terminal by pressing <code>Ctrl</code>+<code>Alt</code>+<code>F2(top row right arrow)</code>, then log in as user <code>chronos</code> with no password
# Run chrx: <code>cd ; curl -O <nowiki>https://chrx.org/go</nowiki> && sh go</code> (see [https://chrx.org/#options chrx docs] for additional options)
# Follow on-screen prompts to repartition your SSD and install GalliumOS. If this is the first time running chrx on this ChromeOS machine, chrx will reboot after the partitioning step and you will need to continue the installation by running chrx again with the same command line.
# After reboot, at the white "OS verification is OFF" screen, press <code>Ctrl</code>+<code>L</code> for GalliumOS, or <code>Ctrl</code>+<code>D</code> for ChromeOS

== Specific Device Install Documents ==
Our community is also making in-depth install guides for certain devices. Below is a list.
* Acer
** [[Installing/Parrot|Parrot (Acer C710, Acer C7)]]
** [[Installing/Peppy|Peppy (Acer C720, Acer C720P)]]
* ASUS
** [[Installing/Panther|Panther (ASUS Chromebox 2014)]]
* Dell
** [[Installing/Lulu|Lulu (Dell Chromebook 13)]]
* Google
**[[Installing/Samus|Samus (Google Pixel 2015)]]
* HP
** [[Installing/Kip|Kip (HP Chromebook 11 G3, HP Chromebook 11 G4, HP Chromebook 14 G4)]]
* Samsung
** [[Installing/Winky|Winky (Samsung Chromebook 2 2014)]]
__FORCETOC__

== Additional Software ==
[[Additional_Software|Additional Software for GalliumOS]]

== Developer Installation ==

You can install GalliumOS as a virtual machine in order to do user-space software development and testing. Obviously hardware-specific issues will not be debuggable in these environments.

* [[Installing/VirtualBox | VirtualBox]]
* VMWare (Fusion) [[Installing/VMWareFusion]]

Installing/VirtualBox

2018-05-28T07:04:01Z

Nbastin: /* Profile Tweaks */

= Installing in VirtualBox =

Installation in VirtualBox is simple, but requires some special settings in initial VM setup to make sure that the hardware provided to the OS matches that which might exist in ChromeOS devices.

The first step is to download an installation ISO, available from [https://galliumos.org/download the Gallium OS download site]. The best option is to choose the ''Sandy / Ivy Bridge'' ISO, although some others may work.

== Set up VirtualBox VM Profile ==

=== Basic Setup ===

* Select '''New''' from your VirtualBox UI toolbar
* If you see an '''Expert Mode''' button at the bottom of the window, click that now
* Set the name of your VM to anything you want
* Change the '''Type''' to ''Linux''
* Change the '''Version''' to ''Linux 2.6 / 3.x / 4.x (64-bit)'' (These options may change in the future - use the similarly generic option)
* Set the '''Memory size''' to anything 1024 MB and above, as required for your development needs
* Select '''Create a virtual hard disk now''', which should be the default
* Click the '''Create''' button
** The default settings of '''VDI''' and '''8GB''' are fine for disk file location and settings
* Click '''Create''' button again

You should now have a profile that looks something like the image below:

[[File:Vbox-initial.png]]

=== Profile Tweaks ===

There are two important changes to make - one of which would otherwise prevent Gallium from installing, and the other would prevent it from working once you have installed.

In order to allow basic GalliumOS installation, you need to fix the optical drive to be attached to the SATA controller:

* Click on the '''Storage''' header
* Select the IDE controller line and click the icon at the bottom of the pane to remove the controller:
[[File:Remove-controller.png]]
* Select the remaining SATA Controller line and click the icon to add an optical drive:
[[File:Add-optical.png]]
* Click the button for '''Choose Disk''' and select the ISO you have downloaded:
[[File:Chosen-disk.png]]
* Click '''OK''' and close the '''Storage''' customization dialog

These settings will allow the Gallium Live ISO to boot and be installed. However, the installed OS will not have working video without the options below:

* Click the '''Display''' header
* Select the '''Remote Display''' tab
* Check the '''Enable Server''' box
[[File:Enable-VB-Display.png]]

You can change the settings in this pane as appropriate for your environment - the only requirement is that the server be enabled.

* Click '''OK''' and exit the ''Display'' settings editor.

=== Boot the Installer ISO ===

* Click the '''Start''' button in the toolbar at the top of the window
[[File:vbox-start.png]]

A number of overlay messages will show up on the screen, you may close those at any time. Once your ISO is booted you will see:

[[File:basic-boot-vbox.png]]

* Double click on the '''Install GalliumOS 2.1''' icon in the top left

The installer will walk you through the installation - choose the options that make the most sense for your environment. The defaults are fine unless you need to change your language, keyboard layout, or time zone.

The installer will automatically eject the install media at the end of installation when you reboot the VM. You will need to hit ''Enter'' to proceed into your next boot after the install is completed and you have clicked the '''Restart''' button:

[[File:vbox-reboot.png]]

You will now restart into a working GalliumOS installation!

Installing/VirtualBox

2018-05-28T07:02:33Z

Nbastin:

= Installing in VirtualBox =

Installation in VirtualBox is simple, but requires some special settings in initial VM setup to make sure that the hardware provided to the OS matches that which might exist in ChromeOS devices.

The first step is to download an installation ISO, available from [https://galliumos.org/download the Gallium OS download site]. The best option is to choose the ''Sandy / Ivy Bridge'' ISO, although some others may work.

== Set up VirtualBox VM Profile ==

=== Basic Setup ===

* Select '''New''' from your VirtualBox UI toolbar
* If you see an '''Expert Mode''' button at the bottom of the window, click that now
* Set the name of your VM to anything you want
* Change the '''Type''' to ''Linux''
* Change the '''Version''' to ''Linux 2.6 / 3.x / 4.x (64-bit)'' (These options may change in the future - use the similarly generic option)
* Set the '''Memory size''' to anything 1024 MB and above, as required for your development needs
* Select '''Create a virtual hard disk now''', which should be the default
* Click the '''Create''' button
** The default settings of '''VDI''' and '''8GB''' are fine for disk file location and settings
* Click '''Create''' button again

You should now have a profile that looks something like the image below:

[[File:Vbox-initial.png]]

=== Profile Tweaks ===

There are two important changes to make - one of which will prevent Gallium from installing, and the other will prevent it from working once you have installed.

In order to allow basic GalliumOS installation, you need to fix the optical drive to be attached to the SATA controller:

* Click on the '''Storage''' header
* Select the IDE controller line and click the icon at the bottom of the pane to remove the controller:
[[File:Remove-controller.png]]
* Select the remaining SATA Controller line and click the icon to add an optical drive:
[[File:Add-optical.png]]
* Click the button for '''Choose Disk''' and select the ISO you have downloaded:
[[File:Chosen-disk.png]]
* Click '''OK''' and close the '''Storage''' customization dialog

These settings will allow the Gallium Live ISO to boot and be installed. However, the installed OS will not have working video without the options below:

* Click the '''Display''' header
* Select the '''Remote Display''' tab
* Check the '''Enable Server''' box
[[File:Enable-VB-Display.png]]

You can change the settings in this pane as appropriate for your environment - the only requirement is that the server be enabled.

* Click '''OK''' and exit the ''Display'' settings editor.

=== Boot the Installer ISO ===

* Click the '''Start''' button in the toolbar at the top of the window
[[File:vbox-start.png]]

A number of overlay messages will show up on the screen, you may close those at any time. Once your ISO is booted you will see:

[[File:basic-boot-vbox.png]]

* Double click on the '''Install GalliumOS 2.1''' icon in the top left

The installer will walk you through the installation - choose the options that make the most sense for your environment. The defaults are fine unless you need to change your language, keyboard layout, or time zone.

The installer will automatically eject the install media at the end of installation when you reboot the VM. You will need to hit ''Enter'' to proceed into your next boot after the install is completed and you have clicked the '''Restart''' button:

[[File:vbox-reboot.png]]

You will now restart into a working GalliumOS installation!

File:Vbox-reboot.png

2018-05-28T07:02:14Z

Nbastin:

Installing/VirtualBox

2018-05-28T06:58:28Z

Nbastin:

= Installing in VirtualBox =

Installation in VirtualBox is simple, but requires some special settings in initial VM setup to make sure that the hardware provided to the OS matches that which might exist in ChromeOS devices.

The first step is to download an installation ISO, available from [https://galliumos.org/download the Gallium OS download site]. The best option is to choose the ''Sandy / Ivy Bridge'' ISO, although some others may work.

== Set up VirtualBox VM Profile ==

=== Basic Setup ===

* Select '''New''' from your VirtualBox UI toolbar
* If you see an '''Expert Mode''' button at the bottom of the window, click that now
* Set the name of your VM to anything you want
* Change the '''Type''' to ''Linux''
* Change the '''Version''' to ''Linux 2.6 / 3.x / 4.x (64-bit)'' (These options may change in the future - use the similarly generic option)
* Set the '''Memory size''' to anything 1024 MB and above, as required for your development needs
* Select '''Create a virtual hard disk now''', which should be the default
* Click the '''Create''' button
** The default settings of '''VDI''' and '''8GB''' are fine for disk file location and settings
* Click '''Create''' button again

You should now have a profile that looks something like the image below:

[[File:Vbox-initial.png]]

=== Profile Tweaks ===

There are two important changes to make - one of which will prevent Gallium from installing, and the other will prevent it from working once you have installed.

In order to allow basic GalliumOS installation, you need to fix the optical drive to be attached to the SATA controller:

* Click on the '''Storage''' header
* Select the IDE controller line and click the icon at the bottom of the pane to remove the controller:
[[File:Remove-controller.png]]
* Select the remaining SATA Controller line and click the icon to add an optical drive:
[[File:Add-optical.png]]
* Click the button for '''Choose Disk''' and select the ISO you have downloaded:
[[File:Chosen-disk.png]]
* Click '''OK''' and close the '''Storage''' customization dialog

These settings will allow the Gallium Live ISO to boot and be installed. However, the installed OS will not have working video without the options below:

* Click the '''Display''' header
* Select the '''Remote Display''' tab
* Check the '''Enable Server''' box
[[File:Enable-VB-Display.png]]

You can change the settings in this pane as appropriate for your environment - the only requirement is that the server be enabled.

* Click '''OK''' and exit the ''Display'' settings editor.

=== Boot the Installer ISO ===

* Click the '''Start''' button in the toolbar at the top of the window
[[File:vbox-start.png]]

A number of overlay messages will show up on the screen, you may close those at any time. Once your ISO is booted you will see:

[[File:basic-boot-vbox.png]]

* Double click on the '''Install GalliumOS 2.1''' icon in the top left

The installer will walk you through the installation - choose the options that make the most sense for your environment. The defaults are fine unless you need to change your language, keyboard layout, or time zone.

File:Basic-boot-vbox.png

2018-05-28T06:55:58Z

Nbastin:

File:Vbox-start.png

2018-05-28T06:52:59Z

Nbastin:

File:Enable-VB-Display.png

2018-05-28T06:50:33Z

Nbastin:

Installing/VirtualBox

2018-05-28T06:47:18Z

Nbastin:

File:Chosen-disk.png

2018-05-28T06:46:26Z

Nbastin:

File:Add-optical.png

2018-05-28T06:44:13Z

Nbastin:

File:Remove-controller.png

2018-05-28T06:42:28Z

Nbastin:

Installing/VirtualBox

2018-05-28T06:37:25Z

Nbastin:

File:Vbox-initial.png

2018-05-28T06:34:00Z

Nbastin:

Installing/VirtualBox

2018-05-28T06:32:53Z

Nbastin:

Installing/VirtualBox

2018-05-28T05:51:51Z

Nbastin: Created page with "= Installing in VirtualBox ="

= Installing in VirtualBox =

Installing

2018-05-28T05:50:59Z

Nbastin:

== General Install Instructions ==
You have two possible options for installing GalliumOS:
# '''From an ISO image on a USB drive or SD card''' This method enables you to entirely replace ChromeOS on your internal SSD or HDD. It also allows you to set up more complex configurations such as dual-booting alongside Windows or other Linux distributions.
# '''From the ChromeOS command-line using chrx''' This method will configure your device to dual-boot GalliumOS alongside ChromeOS.

See [[Hardware Compatibility]] for the installation options available for your ChromeOS device model.

=== Traditional ISO Install ===

The traditional installer allows you to use your entire SSD or HDD for GalliumOS. You will need to use a USB flash drive or SD card. You can even boot the GalliumOS Live image to try out the features of GalliumOS before you decide to install!

# Go to [[Installing/Preparing]] and get your Chromebook ready to run GalliumOS
# [https://galliumos.org/download Download] the appropriate GalliumOS ISO for your device
# Write (or "burn") the ISO to a USB flash drive or an SD card
#* Detailed instructions at [[Installing/Creating Bootable USB]]
# Plug your USB flash drive or SD card into your Chromebook
# Reboot your Chromebook and boot from the USB flash drive or SD card
#* If you have the white "OS verification is OFF" screen, press <code>Ctrl</code>+<code>L</code>
#* If you have installed custom firmware, press Esc at the BIOS screen and select the USB device
# Wait for GalliumOS to boot up. Once in the live environment you can play around with GalliumOS, or you can install it using the Install GalliumOS icon on the desktop
# After reboot, press <code>Ctrl</code>+<code>L</code> to access GalliumOS (this requirement can be bypassed for single-boot on most models, see [[Firmware]])

'''Important:''' If you choose an ISO install of GalliumOS (thus removing ChromeOS), and choose to use the Legacy Boot Mode of the stock firmware (ie, with the stock or updated RW_LEGACY firmware), and you allow your battery to drain completely, you might have a problem booting GalliumOS. This is due to the Developer Mode boot flag enabling Legacy Boot mode being reset when power is lost - see [https://wiki.galliumos.org/Firmware#crossystem crossystem flags].

This is easily fixable, but it's preferable to avoid the issue entirely by either setting the corresponding firmware boot flag (which is not reset when power is lost), or by flashing custom Full ROM firmware - see [[Firmware]]

=== chrx Installation ===

Installing GalliumOS via [https://chrx.org/ chrx] allows you to dual-boot GalliumOS alongside ChromeOS. Check the [https://chrx.org/#compatibility chrx hardware compatibility list] to see if your device supports chrx, and whether any preparation steps are required.

See [https://chrx.org#usage chrx installation instructions] for full details, but here's a quick overview:

# Prepare your ChromeOS device: see [[Installing/Preparing]]
# Boot device into ChromeOS and configure networking; you do not need to log in
# Switch to a virtual terminal by pressing <code>Ctrl</code>+<code>Alt</code>+<code>F2(top row right arrow)</code>, then log in as user <code>chronos</code> with no password
# Run chrx: <code>cd ; curl -O <nowiki>https://chrx.org/go</nowiki> && sh go</code> (see [https://chrx.org/#options chrx docs] for additional options)
# Follow on-screen prompts to repartition your SSD and install GalliumOS. If this is the first time running chrx on this ChromeOS machine, chrx will reboot after the partitioning step and you will need to continue the installation by running chrx again with the same command line.
# After reboot, at the white "OS verification is OFF" screen, press <code>Ctrl</code>+<code>L</code> for GalliumOS, or <code>Ctrl</code>+<code>D</code> for ChromeOS

== Specific Device Install Documents ==
Our community is also making in-depth install guides for certain devices. Below is a list.
* Acer
** [[Installing/Parrot|Parrot (Acer C710, Acer C7)]]
** [[Installing/Peppy|Peppy (Acer C720, Acer C720P)]]
* ASUS
** [[Installing/Panther|Panther (ASUS Chromebox 2014)]]
* Dell
** [[Installing/Lulu|Lulu (Dell Chromebook 13)]]
* Google
**[[Installing/Samus|Samus (Google Pixel 2015)]]
* HP
** [[Installing/Kip|Kip (HP Chromebook 11 G3, HP Chromebook 11 G4, HP Chromebook 14 G4)]]
* Samsung
** [[Installing/Winky|Winky (Samsung Chromebook 2 2014)]]
__FORCETOC__

== Additional Software ==
[[Additional_Software|Additional Software for GalliumOS]]

== Developer Installation ==

You can install GalliumOS as a virtual machine in order to do user-space software development and testing. Obviously hardware-specific issues will not be debuggable in these environments.

* VirtualBox [[Installing/VirtualBox]]
* VMWare (Fusion) [[Installing/VMWareFusion]]