Blame - Bliss OS/installation-guide/index.html - Documentation-release

<p>These instructions are based on the Android-x86 project's installation guide. We have not changed the installer, so the procedure of installation is similar. We also thank @bg260 for his contributions - this guide was adapted partially from his work.</p>

711

<h2 id="warning">Warning!</h2>

712

<p>Team Bliss <strong>does NOT accept any responsibility</strong>. Users must read and understand the instructions, as the installation modifies core system files and carries a significant risk. You <strong>accept all responsibility</strong>, including but not limited to data loss and other malfunctions by continuing beyond this point.</p>

713

<p>Any questions, install issues, bug reports, etc. <strong>MUST be</strong> accompanied with the following things:</p>

<ul>

<li>Device info</li>

<li>Build info (file name)</li>

718

<li>Installation method (exact steps used)</li>

719

<li>Any other relevant information REQUIRED to diagnose your issue as NOT user error</li>

720

</ul>

721

<p>If the following information is not supplied, your inquiry will be <strong>ignored.</strong></p>

722

<p>These instructions have changed quite a bit for Android Pie, so consider this section a <strong>work in progress.</strong> Thank you for your patience!</p>

Eric Park

d09b00e

2020-02-15 11:07:48 +0900

[diff] [blame]

723

<h2 id="windows-installation-method">Windows installation method</h2>

724

<p><strong>This is the current recommended method for beginners!</strong></p>

725

<p>We recommend beginners to use this method as it is the least error-prone and non-destructive. The following instructions were adapted from the Android-x86 project, so some of the images are from them. <a href="https://www.android-x86.org/installhowto.html">To look at Android-x86's original installation guide, click here.</a></p>

726

<p>When booting into the installer, choose "Installation - Install Android-x86 to harddisk":</p>

727

728

<p>Once the installer boots, you will be asked to select the target drive. Choose the NTFS drive that houses your current Windows install. You do <strong>not</strong> need a separate partition, as the installer will create an image on your Windows partition.</p>

729

730

<p>Choose "Do not re-format" on the next screen. It is important that you choose "Do not re-format", as any other option will cause the installer to continue with the <a href="#bootable-installation-method-mbruefiesp-3264-bit">"Bootable installation method"</a>, which <strong>will</strong> result in <strong>permanent data loss</strong>, including your Windows partition!</p>

731

732

<p>Choose "Yes" when prompted about the <code>grub</code> bootloader:</p>

733

734

<p>The installer will ask whether or not you want to make the system partition read/write-able. If you want to root your installation, you will choose "Yes" here. Otherwise, choose "No."</p>

735

736

<p>The installer will begin to write the changes to the disk. This will take some time. Go grab a coffee!</p>

737

738

<p>Then the installer will ask you how much space you want to allocate for the data image. Most users choose 8 GB, 16 GB, or 32 GB.</p>

739

<p>Congratulations! You should now have a functional dual-boot with Bliss OS!</p>

Eric Park

608ce5a

2019-08-07 21:27:46 +0800

[diff] [blame]

740

<h2 id="bootable-installation-method-mbruefiesp-3264-bit">Bootable installation method - MBR/UEFI/ESP (32/64-bit)</h2>

Eric Park

d09b00e

2020-02-15 11:07:48 +0900

[diff] [blame]

741

<p><strong>This is the current recommended method for advanced users!</strong></p>

Eric Park

608ce5a

2019-08-07 21:27:46 +0800

[diff] [blame]

742

<p>Overview of the steps:</p>

743

<ul>

744

<li>Download the ISO file</li>

745

<li>Use Rufus or similar to burn to USB drive</li>

746

<li>Disable Secure Boot, Bitlocker, and any other boot security software such as Veracrypt</li>

747

<li>Boot into the USB drive.</li>

748

<li>Run Bliss OS in Live mode to test things out. If all is well, continue to next step</li>

749

<li>Boot into the USB drive, and choose Bliss OS Install</li>

750

</ul>

751

<p>Let's get started!</p>

752

<h3 id="part-1-gather-your-tools">Part 1 - Gather Your Tools</h3>

753

<p><strong>Please note that this method is not supported on all machines.</strong></p>

754

<p>Download <a href="https://rufus.ie">Rufus</a> and the 32-bit <code>.iso</code> or 64-bit <code>.iso</code>/<code>.img</code> file of Bliss OS, depending on the architecture of the machine you are installing Bliss OS on.</p>

755

<p>You will need a decent speed USB drive (4 GB or larger is recommended).</p>

756

<h3 id="part-2-flashing-bliss-os-to-the-usb-drive">Part 2 - Flashing Bliss OS to the USB drive</h3>

757

<p>Plug in your USB drive, and load up Rufus. Once loaded, click on the icon next to the ISO Image dropdown menu. Now browse to where you have your Bliss OS (32-bit) <code>.iso</code>, <em>or</em> your Bliss OS (64-bit) <code>.iso</code>/<code>.img</code> file. Once chosen, the dropdown should switch to the correct image type, and fill the rest in for you. Once you are ready, click Start.</p>

758

<h3 id="part-3-testing-bliss-os-on-your-system">Part 3 - Testing Bliss OS on your system</h3>

759

<p><strong>This is very important!</strong> If you, as a user, <strong>do NOT</strong> test the OS first to make sure it is compatible with your device, please <strong>do NOT</strong> expect us to help you if you happen to install it blindly and something goes wrong.</p>

Eric Park

5ae1c6c

2019-08-21 11:08:22 -0700

[diff] [blame]

760

<p>Reboot your machine, and enter the BIOS. Most motherboards have the default key as "F2". Change the boot order so that the USB is the first thing the device will boot to. Once the boot orders are changed, reboot. If everything goes well, you should see a <code>grub</code> boot screen. Select the "Live CD" option, and if your machine is compatible, you should then see a little bit of text, and then the Bliss OS boot animation. This will go on for a few minutes, but should eventually boot to Bliss OS. If the system never boots to Bliss OS, this is a bad sign that your system might not be compatible. If it does boot, and you would like to install it, continue to the next step.

761

For those wanting to use root, you will need to install the OS and be running of that install. Root will not function properly in Live Mode. </p>

Eric Park

608ce5a

2019-08-07 21:27:46 +0800

[diff] [blame]

762

<h4 id="troubleshooting-booting-from-the-usb-kicks-me-back-to-bios-or-back-to-my-windowsmacoslinux-installation">Troubleshooting - Booting from the USB kicks me back to BIOS, or back to my Windows/macOS/Linux installation.</h4>

763

<p>Your drive is incompatible or you have formatted it incorrectly. Try flashing the image again to the drive with Rufus. If that does not work, your device does not support booting from USB and you will have to try an alternate method.</p>

764

<h3 id="part-3-alternate-using-bliss-os-from-your-usb-drive">Part 3 (alternate) - Using Bliss OS from your USB drive</h3>

765

<p>If you choose to use Bliss from the USB drive, the data you modify or create on the live install will be in an ephemeral state unless you create a <code>data.img</code> to store the data. You can create a <code>data.img</code> in the root directory of the USB drive (make sure you have a minimum of 4-5 GB free on the drive). We suggest using a tool like RMXtools from XDA to create it (version 1.7 is recommended). Check the tool's thread for detailed usage instructions. You will want to create your <code>data.img</code> inside the root directory of your USB drive, with all the other <code>.img</code> files. From there, just boot into live mode, setup your system the way you want, and the data should be persistant across reboots.</p>

766

<h3 id="part-4-setting-up-and-installing-bliss-os-on-your-hddssdsd-card">Part 4 - Setting up and Installing Bliss OS on your HDD/SSD/SD card</h3>

767

<p>Quick warning again, in case you missed it. Team Bliss is <strong>NOT responsible</strong>, directly or indirectly, for any damages caused by this guide. By continuing, you automatically agree to these terms.</p>

768

<p>This is where things start to get a little tricky, especially with how devices vary. Make sure you have a backup plan in case something goes wrong.</p>

769

<p>Start off by opening your favorite partition management software, such as Disk Management in Windows, and create a new partition, making it the size you want (suggested minimum is 8 GB). Just format it to NTFS for now, because it will be formatted by the installer later into the process anyway. Remember what drive you have created here as it's important later on. For Windows machines, it will typically be <code>sda4</code> or <code>sda5</code>. Also create another 300 MB FAT32 partition for the <code>grub</code> bootloader to install to. (This part might require a third-party partition manager as Windows Disk Management might not let it be that small.)</p>

770

<p>Boot up the Bliss OS USB, and select the "Installation" option in <code>grub</code>. (It is the second one down, usually.)</p>

771

<p>The installer will load, and you will have an option to choose the partition you created earlier. Pick it, and select <code>ext4</code>. <strong>DO NOT</strong> blindly choose the partition, as an incorrect flash can mess up your drive and cause serious data loss. <strong>You do NOT want to get this step wrong.</strong> If you are unsure, boot back into Windows/macOS/Linux and write it down.</p>

Eric Park

5ae1c6c

2019-08-21 11:08:22 -0700

[diff] [blame]

772

<p>When it asks if you want to install system as R/W, select "YES" if you want to use root (SuperSU), and "No" if you do not need root.</p>

Eric Park

608ce5a

2019-08-07 21:27:46 +0800

[diff] [blame]

773

<p>When it asks if you want to install <code>grub</code>, select "Grub for Legacy BIOS boot type", "Grub2 for UEFI boot type", or neither if you are already running a Linux system. If you chose to install <code>grub</code>, the installer will allow you to choose the partition to install <code>grub</code> to. Make sure you select the 300 MB partition you set up earlier for <code>grub</code>.</p>

774

<p>The process will install and create the data directory/image, so be patient. When finished, the installer will then ask if you want to run Android-x86. You can just reboot here. Make sure you remove the USB drive.</p>

775

<p>If we have followed all the directions correctly, you should be presented with a <code>grub</code> boot menu. You can choose your <code>bliss_android_x86</code> option (or <code>android-x86</code>), and it will boot into Bliss OS. If you want to customize your <code>grub</code> boot entry, search the web first. We use the same <code>grub</code> setup that the Android-x86 project uses, so their forums will contain just about all the info you will need. </p>

776

<p>Congratulations! We hope you enjoy using Bliss OS.</p>

Eric Park

608ce5a

2019-08-07 21:27:46 +0800

[diff] [blame]

777

<h2 id="conclusion">Conclusion</h2>

778

<p>Thanks for following along! If you want to check out the next guide, <a href="../extras/">click here!</a></p>

779

<p>Having problems with your new installation? <a href="../troubleshooting/">Check out Troubleshooting.</a></p>