Gitiles
Code Review Sign In
review.blissroms.org / Documentation-release / 25f686617b0fe19d7ecd24770d0de5369ac28265 / . / Bliss OS / installation-guide / index.html
blob: e4021b832c00c6385b04744638eaa88e227130b5 [file] [log] [blame]
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]1
2
3
4
5<!doctype html>
6<html lang="en" class="no-js">
7 <head>
8
9 <meta charset="utf-8">
10 <meta name="viewport" content="width=device-width,initial-scale=1">
11 <meta http-equiv="x-ua-compatible" content="ie=edge">
12
13
14
15
16 <meta name="lang:clipboard.copy" content="Copy to clipboard">
17
18 <meta name="lang:clipboard.copied" content="Copied to clipboard">
19
20 <meta name="lang:search.language" content="en">
21
22 <meta name="lang:search.pipeline.stopwords" content="True">
23
24 <meta name="lang:search.pipeline.trimmer" content="True">
25
26 <meta name="lang:search.result.none" content="No matching documents">
27
28 <meta name="lang:search.result.one" content="1 matching document">
29
30 <meta name="lang:search.result.other" content="# matching documents">
31
32 <meta name="lang:search.tokenizer" content="[\s\-]+">
33
34 <link rel="shortcut icon" href="../../assets/images/favicon.png">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]35 <meta name="generator" content="mkdocs-1.0.4, mkdocs-material-4.4.3">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]36
37
38
39 <title>Installation Guide - Team Bliss</title>
40
41
42
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]43 <link rel="stylesheet" href="../../assets/stylesheets/application.30686662.css">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]44
45
46
47
48 <script src="../../assets/javascripts/modernizr.74668098.js"></script>
49
50
51
52 <link href="https://fonts.gstatic.com" rel="preconnect" crossorigin>
53 <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,400,400i,700|Roboto+Mono&display=fallback">
54 <style>body,input{font-family:"Roboto","Helvetica Neue",Helvetica,Arial,sans-serif}code,kbd,pre{font-family:"Roboto Mono","Courier New",Courier,monospace}</style>
55
56
57 <link rel="stylesheet" href="../../assets/fonts/material-icons.css">
58
59
60
61
62
63
64 </head>
65
66 <body dir="ltr">
67
68 <svg class="md-svg">
69 <defs>
70
71
72 </defs>
73 </svg>
74 <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
75 <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
76 <label class="md-overlay" data-md-component="overlay" for="__drawer"></label>
77
78 <a href="#installation-guide" tabindex="1" class="md-skip">
79 Skip to content
80 </a>
81
82
83 <header class="md-header" data-md-component="header">
84 <nav class="md-header-nav md-grid">
85 <div class="md-flex">
86 <div class="md-flex__cell md-flex__cell--shrink">
87 <a href="../.." title="Team Bliss" class="md-header-nav__button md-logo">
88
89 <i class="md-icon"></i>
90
91 </a>
92 </div>
93 <div class="md-flex__cell md-flex__cell--shrink">
94 <label class="md-icon md-icon--menu md-header-nav__button" for="__drawer"></label>
95 </div>
96 <div class="md-flex__cell md-flex__cell--stretch">
97 <div class="md-flex__ellipsis md-header-nav__title" data-md-component="title">
98
99 <span class="md-header-nav__topic">
100 Team Bliss
101 </span>
102 <span class="md-header-nav__topic">
103
104 Installation Guide
105
106 </span>
107
108 </div>
109 </div>
110 <div class="md-flex__cell md-flex__cell--shrink">
111
112 <label class="md-icon md-icon--search md-header-nav__button" for="__search"></label>
113
114<div class="md-search" data-md-component="search" role="dialog">
115 <label class="md-search__overlay" for="__search"></label>
116 <div class="md-search__inner" role="search">
117 <form class="md-search__form" name="search">
118 <input type="text" class="md-search__input" name="query" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="query" data-md-state="active">
119 <label class="md-icon md-search__icon" for="__search"></label>
120 <button type="reset" class="md-icon md-search__icon" data-md-component="reset" tabindex="-1">
121 &#xE5CD;
122 </button>
123 </form>
124 <div class="md-search__output">
125 <div class="md-search__scrollwrap" data-md-scrollfix>
126 <div class="md-search-result" data-md-component="result">
127 <div class="md-search-result__meta">
128 Type to start searching
129 </div>
130 <ol class="md-search-result__list"></ol>
131 </div>
132 </div>
133 </div>
134 </div>
135</div>
136
137 </div>
138
139 </div>
140 </nav>
141</header>
142
143 <div class="md-container">
144
145
146
147
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]148 <main class="md-main" role="main">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]149 <div class="md-main__inner md-grid" data-md-component="container">
150
151
152 <div class="md-sidebar md-sidebar--primary" data-md-component="navigation">
153 <div class="md-sidebar__scrollwrap">
154 <div class="md-sidebar__inner">
155 <nav class="md-nav md-nav--primary" data-md-level="0">
156 <label class="md-nav__title md-nav__title--site" for="__drawer">
157 <a href="../.." title="Team Bliss" class="md-nav__button md-logo">
158
159 <i class="md-icon"></i>
160
161 </a>
162 Team Bliss
163 </label>
164
165 <ul class="md-nav__list" data-md-scrollfix>
166
167
168
169
170
171
172 <li class="md-nav__item">
Eric Park5e3a1012019-08-12 13:17:03 +0800[diff] [blame]173 <a href="../.." title="Home" class="md-nav__link">
174 Home
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]175 </a>
176 </li>
177
178
179
180
181
182
183
184
185
186 <li class="md-nav__item md-nav__item--active md-nav__item--nested">
187
188 <input class="md-toggle md-nav__toggle" data-md-toggle="nav-2" type="checkbox" id="nav-2" checked>
189
190 <label class="md-nav__link" for="nav-2">
191 Bliss OS
192 </label>
193 <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
194 <label class="md-nav__title" for="nav-2">
195 Bliss OS
196 </label>
197 <ul class="md-nav__list" data-md-scrollfix>
198
199
200
201
202
203
204
205 <li class="md-nav__item">
206 <a href="../" title="Index" class="md-nav__link">
207 Index
208 </a>
209 </li>
210
211
212
213
214
215
216
217 <li class="md-nav__item">
Eric Park5e3a1012019-08-12 13:17:03 +0800[diff] [blame]218 <a href="../build-guide/" title="Build Guide" class="md-nav__link">
219 Build Guide
220 </a>
221 </li>
222
223
224
225
226
227
228
229 <li class="md-nav__item">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]230 <a href="../extras/" title="Extras" class="md-nav__link">
231 Extras
232 </a>
233 </li>
234
235
236
237
238
239
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]240
241 <li class="md-nav__item">
242 <a href="../installation-guide-misc/" title="Installation Guide (Misc)" class="md-nav__link">
243 Installation Guide (Misc)
244 </a>
245 </li>
246
247
248
249
250
251
252
253 <li class="md-nav__item">
254 <a href="../installation-guide-surface-devices/" title="Installation Guide (Surface devices)" class="md-nav__link">
255 Installation Guide (Surface devices)
256 </a>
257 </li>
258
259
260
261
262
263
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]264
265
266
267 <li class="md-nav__item md-nav__item--active">
268
269 <input class="md-toggle md-nav__toggle" data-md-toggle="toc" type="checkbox" id="__toc">
270
271
272
273
274 <label class="md-nav__link md-nav__link--active" for="__toc">
275 Installation Guide
276 </label>
277
278 <a href="./" title="Installation Guide" class="md-nav__link md-nav__link--active">
279 Installation Guide
280 </a>
281
282
283<nav class="md-nav md-nav--secondary">
284
285
286
287
288
289 <label class="md-nav__title" for="__toc">Table of contents</label>
290 <ul class="md-nav__list" data-md-scrollfix>
291
292 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]293 <a href="#preface" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]294 Preface
295 </a>
296
297</li>
298
299 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]300 <a href="#warning" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]301 Warning!
302 </a>
303
304</li>
305
306 <li class="md-nav__item">
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]307 <a href="#windows-installation-method" class="md-nav__link">
308 Windows installation method
309 </a>
310
311</li>
312
313 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]314 <a href="#bootable-installation-method-mbruefiesp-3264-bit" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]315 Bootable installation method - MBR/UEFI/ESP (32/64-bit)
316 </a>
317
318 <nav class="md-nav">
319 <ul class="md-nav__list">
320
321 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]322 <a href="#part-1-gather-your-tools" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]323 Part 1 - Gather Your Tools
324 </a>
325
326</li>
327
328 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]329 <a href="#part-2-flashing-bliss-os-to-the-usb-drive" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]330 Part 2 - Flashing Bliss OS to the USB drive
331 </a>
332
333</li>
334
335 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]336 <a href="#part-3-testing-bliss-os-on-your-system" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]337 Part 3 - Testing Bliss OS on your system
338 </a>
339
340 <nav class="md-nav">
341 <ul class="md-nav__list">
342
343 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]344 <a href="#troubleshooting-booting-from-the-usb-kicks-me-back-to-bios-or-back-to-my-windowsmacoslinux-installation" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]345 Troubleshooting - Booting from the USB kicks me back to BIOS, or back to my Windows/macOS/Linux installation.
346 </a>
347
348</li>
349
350 </ul>
351 </nav>
352
353</li>
354
355 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]356 <a href="#part-3-alternate-using-bliss-os-from-your-usb-drive" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]357 Part 3 (alternate) - Using Bliss OS from your USB drive
358 </a>
359
360</li>
361
362 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]363 <a href="#part-4-setting-up-and-installing-bliss-os-on-your-hddssdsd-card" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]364 Part 4 - Setting up and Installing Bliss OS on your HDD/SSD/SD card
365 </a>
366
367</li>
368
369 </ul>
370 </nav>
371
372</li>
373
374 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]375 <a href="#conclusion" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]376 Conclusion
377 </a>
378
379</li>
380
381
382
383
384
385 </ul>
386
387</nav>
388
389 </li>
390
391
392
393
394
395
396
397 <li class="md-nav__item">
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]398 <a href="../taking-bug-reports/" title="Taking bug reports" class="md-nav__link">
399 Taking bug reports
400 </a>
401 </li>
402
403
404
405
406
407
408
409 <li class="md-nav__item">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]410 <a href="../troubleshooting/" title="Troubleshooting" class="md-nav__link">
411 Troubleshooting
412 </a>
413 </li>
414
415
416 </ul>
417 </nav>
418 </li>
419
420
421
422
423
424
425
426 <li class="md-nav__item md-nav__item--nested">
427
428 <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3" type="checkbox" id="nav-3">
429
430 <label class="md-nav__link" for="nav-3">
431 BlissRoms
432 </label>
433 <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
434 <label class="md-nav__title" for="nav-3">
435 BlissRoms
436 </label>
437 <ul class="md-nav__list" data-md-scrollfix>
438
439
440
441
442
443
444
445 <li class="md-nav__item">
446 <a href="../../BlissRoms/" title="Index" class="md-nav__link">
447 Index
448 </a>
449 </li>
450
451
452
453
454
455
456
457 <li class="md-nav__item">
458 <a href="../../BlissRoms/build-guide/" title="Build Guide" class="md-nav__link">
459 Build Guide
460 </a>
461 </li>
462
463
464
465
466
467
468
469 <li class="md-nav__item">
470 <a href="../../BlissRoms/build-tips/" title="Build Tips" class="md-nav__link">
471 Build Tips
472 </a>
473 </li>
474
475
476 </ul>
477 </nav>
478 </li>
479
480
481
482
483
484
485
486 <li class="md-nav__item md-nav__item--nested">
487
488 <input class="md-toggle md-nav__toggle" data-md-toggle="nav-4" type="checkbox" id="nav-4">
489
490 <label class="md-nav__link" for="nav-4">
491 Common
492 </label>
493 <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
494 <label class="md-nav__title" for="nav-4">
495 Common
496 </label>
497 <ul class="md-nav__list" data-md-scrollfix>
498
499
500
501
502
503
504
505 <li class="md-nav__item">
506 <a href="../../common/" title="Index" class="md-nav__link">
507 Index
508 </a>
509 </li>
510
511
512
513
514
515
516
517 <li class="md-nav__item">
518 <a href="../../common/git-started/" title="Git Started" class="md-nav__link">
519 Git Started
520 </a>
521 </li>
522
523
524
525
526
527
528
529 <li class="md-nav__item">
Eric Park8584eda2019-09-02 09:45:55 +0800[diff] [blame]530 <a href="../../common/maintaining-proper-authorship/" title="Maintaining proper authorship" class="md-nav__link">
531 Maintaining proper authorship
532 </a>
533 </li>
534
535
536
537
538
539
540
541 <li class="md-nav__item">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]542 <a href="../../common/using-dippy-bird/" title="Using `dippy-bird`" class="md-nav__link">
543 Using `dippy-bird`
544 </a>
545 </li>
546
547
548 </ul>
549 </nav>
550 </li>
551
552
553
554
555
556
557
558 <li class="md-nav__item md-nav__item--nested">
559
560 <input class="md-toggle md-nav__toggle" data-md-toggle="nav-5" type="checkbox" id="nav-5">
561
562 <label class="md-nav__link" for="nav-5">
563 Infrastructure
564 </label>
565 <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
566 <label class="md-nav__title" for="nav-5">
567 Infrastructure
568 </label>
569 <ul class="md-nav__list" data-md-scrollfix>
570
571
572
573
574
575
576
577 <li class="md-nav__item">
578 <a href="../../infrastructure/" title="Index" class="md-nav__link">
579 Index
580 </a>
581 </li>
582
583
584 </ul>
585 </nav>
586 </li>
587
588
589 </ul>
590</nav>
591 </div>
592 </div>
593 </div>
594
595
596 <div class="md-sidebar md-sidebar--secondary" data-md-component="toc">
597 <div class="md-sidebar__scrollwrap">
598 <div class="md-sidebar__inner">
599
600<nav class="md-nav md-nav--secondary">
601
602
603
604
605
606 <label class="md-nav__title" for="__toc">Table of contents</label>
607 <ul class="md-nav__list" data-md-scrollfix>
608
609 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]610 <a href="#preface" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]611 Preface
612 </a>
613
614</li>
615
616 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]617 <a href="#warning" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]618 Warning!
619 </a>
620
621</li>
622
623 <li class="md-nav__item">
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]624 <a href="#windows-installation-method" class="md-nav__link">
625 Windows installation method
626 </a>
627
628</li>
629
630 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]631 <a href="#bootable-installation-method-mbruefiesp-3264-bit" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]632 Bootable installation method - MBR/UEFI/ESP (32/64-bit)
633 </a>
634
635 <nav class="md-nav">
636 <ul class="md-nav__list">
637
638 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]639 <a href="#part-1-gather-your-tools" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]640 Part 1 - Gather Your Tools
641 </a>
642
643</li>
644
645 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]646 <a href="#part-2-flashing-bliss-os-to-the-usb-drive" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]647 Part 2 - Flashing Bliss OS to the USB drive
648 </a>
649
650</li>
651
652 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]653 <a href="#part-3-testing-bliss-os-on-your-system" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]654 Part 3 - Testing Bliss OS on your system
655 </a>
656
657 <nav class="md-nav">
658 <ul class="md-nav__list">
659
660 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]661 <a href="#troubleshooting-booting-from-the-usb-kicks-me-back-to-bios-or-back-to-my-windowsmacoslinux-installation" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]662 Troubleshooting - Booting from the USB kicks me back to BIOS, or back to my Windows/macOS/Linux installation.
663 </a>
664
665</li>
666
667 </ul>
668 </nav>
669
670</li>
671
672 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]673 <a href="#part-3-alternate-using-bliss-os-from-your-usb-drive" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]674 Part 3 (alternate) - Using Bliss OS from your USB drive
675 </a>
676
677</li>
678
679 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]680 <a href="#part-4-setting-up-and-installing-bliss-os-on-your-hddssdsd-card" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]681 Part 4 - Setting up and Installing Bliss OS on your HDD/SSD/SD card
682 </a>
683
684</li>
685
686 </ul>
687 </nav>
688
689</li>
690
691 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]692 <a href="#conclusion" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]693 Conclusion
694 </a>
695
696</li>
697
698
699
700
701
702 </ul>
703
704</nav>
705 </div>
706 </div>
707 </div>
708
709
710 <div class="md-content">
711 <article class="md-content__inner md-typeset">
712
713
714
715 <h1 id="installation-guide">Installation Guide</h1>
716<h2 id="preface">Preface</h2>
717<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>
718<h2 id="warning">Warning!</h2>
719<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>
720<p>Any questions, install issues, bug reports, etc. <strong>MUST be</strong> accompanied with the following things:</p>
721<ul>
722<li>Log</li>
723<li>Device info</li>
724<li>Build info (file name)</li>
725<li>Installation method (exact steps used)</li>
726<li>Any other relevant information REQUIRED to diagnose your issue as NOT user error</li>
727</ul>
728<p>If the following information is not supplied, your inquiry will be <strong>ignored.</strong></p>
729<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 Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]730<h2 id="windows-installation-method">Windows installation method</h2>
731<p><strong>This is the current recommended method for beginners!</strong></p>
732<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>
733<p>When booting into the installer, choose "Installation - Install Android-x86 to harddisk":</p>
734<p><img alt="beginner-installation-install-1" src="https://i.imgur.com/gEnnGFp.png" /></p>
735<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>
736<p><img alt="beginner-installation-install-2" src="https://i.imgur.com/fpMo5GS.png" /></p>
737<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>
738<p><img alt="beginner-installation-install-3" src="https://i.imgur.com/QSDt8ia.png" /></p>
739<p>Choose "Yes" when prompted about the <code>grub</code> bootloader:</p>
740<p><img alt="beginner-installation-install-4" src="https://i.imgur.com/PfmjHHi.png" /></p>
741<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>
742<p><img alt="beginner-installation-install-5" src="https://i.imgur.com/SXEeevy.png" /></p>
743<p>The installer will begin to write the changes to the disk. This will take some time. Go grab a coffee!</p>
744<p><img alt="beginner-installation-install-6" src="https://i.imgur.com/iQ4tEAD.png" /></p>
745<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>
746<p>Congratulations! You should now have a functional dual-boot with Bliss OS!</p>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]747<h2 id="bootable-installation-method-mbruefiesp-3264-bit">Bootable installation method - MBR/UEFI/ESP (32/64-bit)</h2>
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]748<p><strong>This is the current recommended method for advanced users!</strong></p>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]749<p>Overview of the steps:</p>
750<ul>
751<li>Download the ISO file</li>
752<li>Use Rufus or similar to burn to USB drive</li>
753<li>Disable Secure Boot, Bitlocker, and any other boot security software such as Veracrypt</li>
754<li>Boot into the USB drive.</li>
755<li>Run Bliss OS in Live mode to test things out. If all is well, continue to next step</li>
756<li>Boot into the USB drive, and choose Bliss OS Install</li>
757</ul>
758<p>Let's get started!</p>
759<h3 id="part-1-gather-your-tools">Part 1 - Gather Your Tools</h3>
760<p><strong>Please note that this method is not supported on all machines.</strong></p>
761<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>
762<p>You will need a decent speed USB drive (4 GB or larger is recommended).</p>
763<h3 id="part-2-flashing-bliss-os-to-the-usb-drive">Part 2 - Flashing Bliss OS to the USB drive</h3>
764<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>
765<h3 id="part-3-testing-bliss-os-on-your-system">Part 3 - Testing Bliss OS on your system</h3>
766<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 Park5ae1c6c2019-08-21 11:08:22 -0700[diff] [blame]767<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.
768For 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 Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]769<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>
770<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>
771<h3 id="part-3-alternate-using-bliss-os-from-your-usb-drive">Part 3 (alternate) - Using Bliss OS from your USB drive</h3>
772<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>
773<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>
774<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>
775<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>
776<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>
777<p>Boot up the Bliss OS USB, and select the "Installation" option in <code>grub</code>. (It is the second one down, usually.)</p>
778<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 Park5ae1c6c2019-08-21 11:08:22 -0700[diff] [blame]779<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 Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]780<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>
781<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>
782<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>
783<p>Congratulations! We hope you enjoy using Bliss OS.</p>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]784<h2 id="conclusion">Conclusion</h2>
785<p>Thanks for following along! If you want to check out the next guide, <a href="../extras/">click here!</a></p>
786<p>Having problems with your new installation? <a href="../troubleshooting/">Check out Troubleshooting.</a></p>
787
788
789
790
791
792
793
794
795
796 </article>
797 </div>
798 </div>
799 </main>
800
801
802<footer class="md-footer">
803
804 <div class="md-footer-nav">
805 <nav class="md-footer-nav__inner md-grid">
806
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]807 <a href="../installation-guide-surface-devices/" title="Installation Guide (Surface devices)" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]808 <div class="md-flex__cell md-flex__cell--shrink">
809 <i class="md-icon md-icon--arrow-back md-footer-nav__button"></i>
810 </div>
811 <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
812 <span class="md-flex__ellipsis">
813 <span class="md-footer-nav__direction">
814 Previous
815 </span>
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]816 Installation Guide (Surface devices)
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]817 </span>
818 </div>
819 </a>
820
821
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]822 <a href="../taking-bug-reports/" title="Taking bug reports" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]823 <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
824 <span class="md-flex__ellipsis">
825 <span class="md-footer-nav__direction">
826 Next
827 </span>
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]828 Taking bug reports
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]829 </span>
830 </div>
831 <div class="md-flex__cell md-flex__cell--shrink">
832 <i class="md-icon md-icon--arrow-forward md-footer-nav__button"></i>
833 </div>
834 </a>
835
836 </nav>
837 </div>
838
839 <div class="md-footer-meta md-typeset">
840 <div class="md-footer-meta__inner md-grid">
841 <div class="md-footer-copyright">
842
843 powered by
844 <a href="https://www.mkdocs.org">MkDocs</a>
845 and
846 <a href="https://squidfunk.github.io/mkdocs-material/">
847 Material for MkDocs</a>
848 </div>
849
850 </div>
851 </div>
852</footer>
853
854 </div>
855
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]856 <script src="../../assets/javascripts/application.ac79c3b0.js"></script>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]857
858 <script>app.initialize({version:"1.0.4",url:{base:"../.."}})</script>
859
860
861 </body>
862</html>