diff --git a/src/.vuepress/config.js b/src/.vuepress/config.js index 20b9da79..9ea13338 100644 --- a/src/.vuepress/config.js +++ b/src/.vuepress/config.js @@ -54,10 +54,6 @@ export default { text: 'FAQ', link: '/docs/faq', }, - { - text: 'Terminology', - link: '/docs/terminology', - }, { text: 'Firmware', link: '/docs/firmware/', @@ -121,10 +117,6 @@ export default { text: 'Flashing Manually', link: '/docs/firmware/manually-flashing', }, - { - text: 'Installing Ventoy With chromeOS', - link: '/docs/firmware/ventoy' - } ] }, { @@ -136,10 +128,6 @@ export default { text: 'Known Issues', link: '/docs/installing/known-issues', }, - { - text: 'Creating a Bootable USB', - link: '/docs/installing/bootableusb', - }, { text: 'Installing Windows', link: '/docs/installing/installing-windows' diff --git a/src/docs/firmware/index.md b/src/docs/firmware/index.md index 3c55344f..a22b763c 100644 --- a/src/docs/firmware/index.md +++ b/src/docs/firmware/index.md @@ -30,10 +30,6 @@ Do not continue if your device is currently owned or enrolled by a organization, Only x86_64 devices are currently supported. ::: -::: tip -If you only have one device, please be sure to [set up a USB with your OS to install](ventoy.md) before flashing. -::: - ## Asking for help properly If you are facing a issue, please read the [FAQ](../faq.md) first. diff --git a/src/docs/firmware/ventoy.md b/src/docs/firmware/ventoy.md deleted file mode 100644 index 495cddcb..00000000 --- a/src/docs/firmware/ventoy.md +++ /dev/null @@ -1,63 +0,0 @@ -# Installing Ventoy to a USB drive with chromeOS - -Ventoy is a useful tool that allows you to have multiple OS installer images on a single drive. It is also the only way to properly create an installer for Windows using chromeOS. - -## Backing up your drive - -Before we begin, be sure to backup any data that may be on your USB drive as it will be erased during this process. - -backup data - -## Downloading Ventoy - -Grab the latest Ventoy release from [GitHub](https://github.com/ventoy/Ventoy/releases). Be sure to get the Linux version. - -download linux version of ventoy - -## Extracting Ventoy - -Open VT-2 by pressing Ctrl + Alt + 🡢 (F2) and run the following commands as root: - -1. `cd /usr/local` -2. `tar xf /home/chronos/user/Downloads/ventoy--linux.tar.gz` -3. `cd ventoy-` - -::: tip -On commands 2 and 3, after typing `ventoy`, you can press tab to fill in the rest of the filename automatically. -::: - -You can then run `ls` to verify you have the correct files, it should look something like this: - -extract tar.gz - -## Starting Ventoy - -Run the following command to start the Ventoy Web GUI: - -- `./VentoyWeb.sh` - -Next, switch back to VT-1 by pressing Ctrl + Alt + 🡠 (F1)and open `http://localhost:24680` in Chrome. - -You should see this on your screen now: - -ventoy launch page - -## Installing Ventoy to USB - -Plug in your USB drive and click the green circle to refresh devices. You should see your USB drive get detected. Now click options, then Partition Style, then choose GPT. - -choose gpt formatting - -Once you have done that and your drive is detected, click on Install and click Ok twice when prompted and again once the installation has completed. Once installation is complete, unplug and plug back in your USB drive. - -## Adding OS images - -Download an image of any OS you want. For Windows we recommend that you only use official ISOs from Microsoft. - -Open Files and click on your USB drive, you should then see a device named "Ventoy". - -picture of ventoy drive - -Copy your images from Downloads to the Ventoy drive. Do not touch VTOYEFI. Once you have done that, eject your USB drive and now you are done. - -picture of where to place isos diff --git a/src/docs/installing/bootableusb.md b/src/docs/installing/bootableusb.md deleted file mode 100644 index 816e9f59..00000000 --- a/src/docs/installing/bootableusb.md +++ /dev/null @@ -1,65 +0,0 @@ -# Making a Bootable USB - -::: danger -Flashing Ventoy or ISOs to an external drive will **wipe all data** on said drive. Back up anything if you need to. -::: - -## Prerequisites - -1. Another PC or laptop with at least 8GB storage -2. An internet connection -3. An external drive like a USB drive or SD card that is at least 8GB. - -## Downloading a ISO - -1. Determine what OS you want. - - For Linux, keep in mind Ubuntu and Ubuntu-based derivatives **are not supported**. - - For Windows, keep in mind only official versions of Windows 10 and newer are supported. -2. Place the ISO in a safe place. - -## Flashing using Rufus (Windows) - -For this guide, we will be using Rufus to create our bootable USB. Rufus is a useful tool that allows you to flash ISOs to an external drive. - -1. Download Rufus from [here](https://rufus.ie/en/). The standard Windows x64 version will do. - - ![image](/rufus.png) - -2. Plug in your external drive. -3. Locate and launch Rufus. It should ask you to launch with administrator privileges, select YES. -4. Press the "SELECT" button on the right-hand side. -5. A File Explorer window should pop up, find your ISO of choice, then click "Open". -6. Click "Start". The default options should work just fine. -7. Wait for the green bar to say "READY", then click "Close" and eject your newly made external drive. -8. Profit - -## Flashing using Ventoy (Windows/Linux/macOS) - -For this guide, we will be using Ventoy to create our bootable USB. -Ventoy allows you to boot multiple ISO's from a single drive. - -1. Download and extract the latest version from [Github](https://www.ventoy.net/en/download.html). - - - Download the respective file for your platform. - ![image](/ventoy/download-alt.png) - -2. Run `Ventoy2Disk.exe` for Windows or `VentoyGUI.x86_64` for Linux. - - - Make sure to allow administrator privilages when prompted. - -3. Plug in your external drive and click the green circle to refresh devices. It should pick up your external drive. -4. Click Options > Partition Style and select "GPT". -5. Once you have done Step 4, click "Install" and click ok twice to start the install. -6. Open your Files App and find a drive that's labeled as "Ventoy". -7. Copy the ISO you downloaded into that drive, after that eject it. -8. Profit - -## Flashing with dd (Linux/macOS) - -1. Plug in your external drive -2. Run `lsblk` to help determine the drive to be flashed. If the device is mounted you will need to use `umount` to unmount it. -3. Flash with `dd if=myfile.iso of=/dev/ bs=16M status=progress`. - -::: tip -Be sure to target the drive itself and not a partition. -::: diff --git a/src/docs/installing/installing-windows.md b/src/docs/installing/installing-windows.md index 1405b437..2e9e243b 100644 --- a/src/docs/installing/installing-windows.md +++ b/src/docs/installing/installing-windows.md @@ -13,10 +13,6 @@ Do not use Windows 8 or older. Only recent Windows 10 and 11 builds are supporte Do not use unofficial versions of Windows, such as Ghost Specter or tiny10/11. **They are not supported** and may contain **undetectable malware** and/or security vulnerabilities. ::: -::: tip -If you want to create a Windows installer from ChromeOS, see the [Installing Ventoy](../firmware/ventoy.md) page. -::: - 1. Get a USB containing a Windows image. Ventoy, Rufus, and the official Windows media creation tool are the only methods that can be used to create a Windows USB. 2. Bypassing Windows 11 installation checks: diff --git a/src/docs/terminology.md b/src/docs/terminology.md deleted file mode 100644 index 59899105..00000000 --- a/src/docs/terminology.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -prev: false -next: firmware/ ---- - -# Terminology - -| **Term** | **Description** | -| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| chrultrabook | A modified Chromebook/box designed to run Windows, Linux, or even macOS | -| coreboot | UEFI firmware firmware replacement | -| UEFI | The Unified Extensible Firmware Interface (UEFI) is a specification that defines a software interface between an operating system and platform firmware. UEFI replaces the legacy Basic Input/Output System (BIOS) firmware interface originally present in all IBM PC-compatible personal computers, with most UEFI firmware implementations providing support for legacy BIOS services. UEFI can support remote diagnostics and repair of computers, even with no operating system installed. (source: Wikipedia) | -| EC | Embedded Controller. Communicates between the main board and embedded peripherals such as hotkeys, ports, or battery. | -| SKL | Abbreviation for Skylake, an Intel CPU generation (6xxx) | -| KBL | Abbreviation for Kaby Lake, an Intel CPU generation (7xxx) | -| APL | Abbreviation for Apollo Lake, an Intel CPU generation (7xxx) | -| ABL | Abbreviation for Amber Lake, an Intel CPU generation (8xxx) | -| GLK | Abbreviation for Gemini Lake, an Intel CPU generation | -| CML | Abbreviation for Comet Lake, an Intel CPU generation (10xxx) | -| TGL | Abbreviation for Tiger Lake, an Intel CPU generation (11xxx) | -| JSL | Abbreviation for Jasper Lake, an Intel CPU generation (Nxxx) | -| ADL | Abbreviation for Alder Lake, an Intel CPU generation (12xxx) | -| SOF | Abbreviation for **S**ound **O**pen **F**irmware, a audio driver used for both Linux and Windows. APL, GLK, CML, TGL, JSL, and ADL use this driver. | -| AVS | Abbreviation for **A**udio **V**oice **S**peech, a audio driver used for both Linux and Windows. SKL, APL, KBL, and ABL use this driver. | -| SuzyQable | A cable that enables CCD (Closed Case Debug). Used to disable WP. | -| NVRAM | Non Volatile Random Access Memory. NVRAM exists on a chip in your motherboard, and contains things like your boot entries/boot order along with a suite of other things. | -| RWL | Abbreviation of RW_Legacy | -| altOS | Stands for **alt**ernate **OS**, a operating system thats not chromeOS. | -| POST | Stands for **P**ower **O**n **S**elf **T**est. POST is a process performed by firmware or software routines immediately after a computer or other digital electronic device is powered on. | -| DRM | Digital rights management (DRM) is the use of technology to control access to copyrighted material. It also enables copyright holders and content creators to manage what users can do with their content, such as how many devices they can access media on and whether they can share it. | -| LTS | Stands for **L**ong **T**erm **S**upport. | -| ACPI | Advanced Configuration and Power Interface (ACPI), an open standard for operating systems to identify and set up computer hardware components. | -| DSDT/SSDT | Tables in your ACPI that describe the devices and how the OS should interact with them e.g. putting the computer to sleep, wake, switching GPUs, USB ports. | -| .AML | The compiled file format of ACPI, and what your PC will execute. .DAT is another extension with the exact same use. | -| .DSL | The source code for ACPI – this is what you edit and compile for your computer. DO NOT mix this file format up with .ASL. | -| Kext(s) | Kernel Extensions, also referred to as Kexts, serve as drivers for macOS. They have various functions, such as facilitating device drivers or serving alternative purposes within Hackintoshing, such as OS patching, information injection, or task execution. It is worth noting that while Kexts play a crucial role in a successful Hackintosh setup, they are typically paired with ACPI patches and fixes. | -| ch341a | A USB programmer used to read/write firmware. You'll need this if you bricked your system | diff --git a/src/index.md b/src/index.md index 21221cc2..4c6bb66f 100644 --- a/src/index.md +++ b/src/index.md @@ -7,6 +7,8 @@ heroImageDark: /chrome.svg actions: - text: Get Started link: /docs/firmware/ +- text: Discuss on the forum + link: https://forum.chrultrabook.com footerHtml: true footer:
@@ -14,15 +16,10 @@ footer:
--- -# What is a chrultrabook and who is this documentation for? +# Who is this documentation for? -A chrultrabook is a modified Chromebook that is able to run Windows, Linux, and sometimes macOS by using MrChromebox’s coreboot firmware. The purpose of this site is to provide documentation that is detailed, user-friendly, and has up-to-date information about the hardware, software, and firmware on Chromebooks. +The chrultrabook documentation is for people who are looking to replace ChromeOS with a different OS. This site contains information on how to replace the OS on your device, along with any extra info you may need to get the most out of your device. --- -## These docs focus on two main things - -- Installing Windows/Linux/macOS on your Chromebook. -- Learning in-depth information about your Chromebook. - -Because of this, you are expected to read, learn, and use Google. **This is NOT a one click procedure.** +Because of the technical nature of this process, you are expected to have some technical background info and troubleshooting skills. **This is NOT a one click procedure.**