Gitiles
Code Review Sign In
review.blissroms.org / Documentation-release / 0509f659f77e5d471e3877c47481b06dd5d72180 / . / Bliss OS / installation-guide-misc / index.html
blob: 98c5e997e20b057579b040b7da670aca267c0b8a [file] [log] [blame]
Eric Parkd09b00e2020-02-15 11:07:48 +0900[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">
35 <meta name="generator" content="mkdocs-1.0.4, mkdocs-material-4.4.3">
36
37
38
39 <title>Installation Guide (Misc) - Team Bliss</title>
40
41
42
43 <link rel="stylesheet" href="../../assets/stylesheets/application.30686662.css">
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-misc" 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 (Misc)
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
148 <main class="md-main" role="main">
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">
173 <a href="../.." title="Home" class="md-nav__link">
174 Home
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">
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">
230 <a href="../extras/" title="Extras" class="md-nav__link">
231 Extras
232 </a>
233 </li>
234
235
236
237
238
239
240
241
242
243 <li class="md-nav__item md-nav__item--active">
244
245 <input class="md-toggle md-nav__toggle" data-md-toggle="toc" type="checkbox" id="__toc">
246
247
248
249
250 <label class="md-nav__link md-nav__link--active" for="__toc">
251 Installation Guide (Misc)
252 </label>
253
254 <a href="./" title="Installation Guide (Misc)" class="md-nav__link md-nav__link--active">
255 Installation Guide (Misc)
256 </a>
257
258
259<nav class="md-nav md-nav--secondary">
260
261
262
263
264
265 <label class="md-nav__title" for="__toc">Table of contents</label>
266 <ul class="md-nav__list" data-md-scrollfix>
267
268 <li class="md-nav__item">
269 <a href="#windows-based-installer-uefiesp-64-bit" class="md-nav__link">
270 Windows-based installer - UEFI/ESP (64-bit)
271 </a>
272
273 <nav class="md-nav">
274 <ul class="md-nav__list">
275
276 <li class="md-nav__item">
277 <a href="#part-1-using-the-installer" class="md-nav__link">
278 Part 1 - Using the Installer
279 </a>
280
281</li>
282
283 <li class="md-nav__item">
284 <a href="#part-2-switching-the-uefiefi-boot-entry" class="md-nav__link">
285 Part 2 - Switching the UEFI/EFI boot entry
286 </a>
287
288</li>
289
290 </ul>
291 </nav>
292
293</li>
294
295 <li class="md-nav__item">
296 <a href="#use-syslinux-efi-to-run-bliss-os-7x10x11x" class="md-nav__link">
297 Use syslinux EFI to run Bliss OS 7.x/10.x/11.x
298 </a>
299
300 <nav class="md-nav">
301 <ul class="md-nav__list">
302
303 <li class="md-nav__item">
304 <a href="#part-1-grab-the-required-tools" class="md-nav__link">
305 Part 1 - Grab the required tools
306 </a>
307
308</li>
309
310 <li class="md-nav__item">
311 <a href="#part-2-get-bliss-os" class="md-nav__link">
312 Part 2 - Get Bliss OS
313 </a>
314
315</li>
316
317 <li class="md-nav__item">
318 <a href="#part-3-get-the-syslinux-efi-bootstrap" class="md-nav__link">
319 Part 3 - Get the syslinux EFI bootstrap
320 </a>
321
322</li>
323
324 <li class="md-nav__item">
325 <a href="#part-4-version-specific" class="md-nav__link">
326 Part 4 - Version specific
327 </a>
328
329 <nav class="md-nav">
330 <ul class="md-nav__list">
331
332 <li class="md-nav__item">
333 <a href="#if-you-are-using-bliss-7x" class="md-nav__link">
334 If you are using Bliss 7.x
335 </a>
336
337</li>
338
339 </ul>
340 </nav>
341
342</li>
343
344 <li class="md-nav__item">
345 <a href="#if-you-are-using-bliss-10x" class="md-nav__link">
346 If you are using Bliss 10.x
347 </a>
348
349</li>
350
351 <li class="md-nav__item">
352 <a href="#part-5-creating-the-data-image" class="md-nav__link">
353 Part 5 - Creating the data image
354 </a>
355
356</li>
357
358 </ul>
359 </nav>
360
361</li>
362
363 <li class="md-nav__item">
364 <a href="#custom-install-bliss-os-8x10x11x-uefiesp-64-bit" class="md-nav__link">
365 Custom Install - Bliss OS 8.x/10.x/11.x UEFI/ESP (64-bit)
366 </a>
367
368 <nav class="md-nav">
369 <ul class="md-nav__list">
370
371 <li class="md-nav__item">
372 <a href="#part-1-mounting-your-uefiesp-partition" class="md-nav__link">
373 Part 1 - Mounting Your UEFI/ESP Partition
374 </a>
375
376 <nav class="md-nav">
377 <ul class="md-nav__list">
378
379 <li class="md-nav__item">
380 <a href="#cmd-is-not-showing-up-what-should-i-do" class="md-nav__link">
381 cmd is not showing up, what should I do?
382 </a>
383
384</li>
385
386 </ul>
387 </nav>
388
389</li>
390
391 <li class="md-nav__item">
392 <a href="#part-1-alternate-esp-setup" class="md-nav__link">
393 Part 1 (alternate) - ESP setup
394 </a>
395
396</li>
397
398 <li class="md-nav__item">
399 <a href="#part-1-alternate-killing-the-explorerexe" class="md-nav__link">
400 Part 1 (alternate) - Killing the explorer.exe
401 </a>
402
403</li>
404
405 </ul>
406 </nav>
407
408</li>
409
410 <li class="md-nav__item">
411 <a href="#part-2-uefi-installation" class="md-nav__link">
412 Part 2 - UEFI installation
413 </a>
414
415 <nav class="md-nav">
416 <ul class="md-nav__list">
417
418 <li class="md-nav__item">
419 <a href="#part-4-the-manual-blissification-of-your-pc" class="md-nav__link">
420 Part 4 - The Manual Blissification of Your PC
421 </a>
422
423</li>
424
425 </ul>
426 </nav>
427
428</li>
429
430 <li class="md-nav__item">
431 <a href="#install-bliss-os-on-a-vm-virtualbox" class="md-nav__link">
432 Install Bliss OS on a VM (virtualbox)
433 </a>
434
435</li>
436
437
438
439
440
441 </ul>
442
443</nav>
444
445 </li>
446
447
448
449
450
451
452
453 <li class="md-nav__item">
454 <a href="../installation-guide-surface-devices/" title="Installation Guide (Surface devices)" class="md-nav__link">
455 Installation Guide (Surface devices)
456 </a>
457 </li>
458
459
460
461
462
463
464
465 <li class="md-nav__item">
466 <a href="../installation-guide/" title="Installation Guide" class="md-nav__link">
467 Installation Guide
468 </a>
469 </li>
470
471
472
473
474
475
476
477 <li class="md-nav__item">
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame^]478 <a href="../taking-bug-reports/" title="Taking bug reports" class="md-nav__link">
479 Taking bug reports
480 </a>
481 </li>
482
483
484
485
486
487
488
489 <li class="md-nav__item">
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]490 <a href="../troubleshooting/" title="Troubleshooting" class="md-nav__link">
491 Troubleshooting
492 </a>
493 </li>
494
495
496 </ul>
497 </nav>
498 </li>
499
500
501
502
503
504
505
506 <li class="md-nav__item md-nav__item--nested">
507
508 <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3" type="checkbox" id="nav-3">
509
510 <label class="md-nav__link" for="nav-3">
511 BlissRoms
512 </label>
513 <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
514 <label class="md-nav__title" for="nav-3">
515 BlissRoms
516 </label>
517 <ul class="md-nav__list" data-md-scrollfix>
518
519
520
521
522
523
524
525 <li class="md-nav__item">
526 <a href="../../BlissRoms/" title="Index" class="md-nav__link">
527 Index
528 </a>
529 </li>
530
531
532
533
534
535
536
537 <li class="md-nav__item">
538 <a href="../../BlissRoms/build-guide/" title="Build Guide" class="md-nav__link">
539 Build Guide
540 </a>
541 </li>
542
543
544
545
546
547
548
549 <li class="md-nav__item">
550 <a href="../../BlissRoms/build-tips/" title="Build Tips" class="md-nav__link">
551 Build Tips
552 </a>
553 </li>
554
555
556 </ul>
557 </nav>
558 </li>
559
560
561
562
563
564
565
566 <li class="md-nav__item md-nav__item--nested">
567
568 <input class="md-toggle md-nav__toggle" data-md-toggle="nav-4" type="checkbox" id="nav-4">
569
570 <label class="md-nav__link" for="nav-4">
571 Common
572 </label>
573 <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
574 <label class="md-nav__title" for="nav-4">
575 Common
576 </label>
577 <ul class="md-nav__list" data-md-scrollfix>
578
579
580
581
582
583
584
585 <li class="md-nav__item">
586 <a href="../../common/" title="Index" class="md-nav__link">
587 Index
588 </a>
589 </li>
590
591
592
593
594
595
596
597 <li class="md-nav__item">
598 <a href="../../common/git-started/" title="Git Started" class="md-nav__link">
599 Git Started
600 </a>
601 </li>
602
603
604
605
606
607
608
609 <li class="md-nav__item">
610 <a href="../../common/maintaining-proper-authorship/" title="Maintaining proper authorship" class="md-nav__link">
611 Maintaining proper authorship
612 </a>
613 </li>
614
615
616
617
618
619
620
621 <li class="md-nav__item">
622 <a href="../../common/using-dippy-bird/" title="Using `dippy-bird`" class="md-nav__link">
623 Using `dippy-bird`
624 </a>
625 </li>
626
627
628 </ul>
629 </nav>
630 </li>
631
632
633
634
635
636
637
638 <li class="md-nav__item md-nav__item--nested">
639
640 <input class="md-toggle md-nav__toggle" data-md-toggle="nav-5" type="checkbox" id="nav-5">
641
642 <label class="md-nav__link" for="nav-5">
643 Infrastructure
644 </label>
645 <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
646 <label class="md-nav__title" for="nav-5">
647 Infrastructure
648 </label>
649 <ul class="md-nav__list" data-md-scrollfix>
650
651
652
653
654
655
656
657 <li class="md-nav__item">
658 <a href="../../infrastructure/" title="Index" class="md-nav__link">
659 Index
660 </a>
661 </li>
662
663
664 </ul>
665 </nav>
666 </li>
667
668
669 </ul>
670</nav>
671 </div>
672 </div>
673 </div>
674
675
676 <div class="md-sidebar md-sidebar--secondary" data-md-component="toc">
677 <div class="md-sidebar__scrollwrap">
678 <div class="md-sidebar__inner">
679
680<nav class="md-nav md-nav--secondary">
681
682
683
684
685
686 <label class="md-nav__title" for="__toc">Table of contents</label>
687 <ul class="md-nav__list" data-md-scrollfix>
688
689 <li class="md-nav__item">
690 <a href="#windows-based-installer-uefiesp-64-bit" class="md-nav__link">
691 Windows-based installer - UEFI/ESP (64-bit)
692 </a>
693
694 <nav class="md-nav">
695 <ul class="md-nav__list">
696
697 <li class="md-nav__item">
698 <a href="#part-1-using-the-installer" class="md-nav__link">
699 Part 1 - Using the Installer
700 </a>
701
702</li>
703
704 <li class="md-nav__item">
705 <a href="#part-2-switching-the-uefiefi-boot-entry" class="md-nav__link">
706 Part 2 - Switching the UEFI/EFI boot entry
707 </a>
708
709</li>
710
711 </ul>
712 </nav>
713
714</li>
715
716 <li class="md-nav__item">
717 <a href="#use-syslinux-efi-to-run-bliss-os-7x10x11x" class="md-nav__link">
718 Use syslinux EFI to run Bliss OS 7.x/10.x/11.x
719 </a>
720
721 <nav class="md-nav">
722 <ul class="md-nav__list">
723
724 <li class="md-nav__item">
725 <a href="#part-1-grab-the-required-tools" class="md-nav__link">
726 Part 1 - Grab the required tools
727 </a>
728
729</li>
730
731 <li class="md-nav__item">
732 <a href="#part-2-get-bliss-os" class="md-nav__link">
733 Part 2 - Get Bliss OS
734 </a>
735
736</li>
737
738 <li class="md-nav__item">
739 <a href="#part-3-get-the-syslinux-efi-bootstrap" class="md-nav__link">
740 Part 3 - Get the syslinux EFI bootstrap
741 </a>
742
743</li>
744
745 <li class="md-nav__item">
746 <a href="#part-4-version-specific" class="md-nav__link">
747 Part 4 - Version specific
748 </a>
749
750 <nav class="md-nav">
751 <ul class="md-nav__list">
752
753 <li class="md-nav__item">
754 <a href="#if-you-are-using-bliss-7x" class="md-nav__link">
755 If you are using Bliss 7.x
756 </a>
757
758</li>
759
760 </ul>
761 </nav>
762
763</li>
764
765 <li class="md-nav__item">
766 <a href="#if-you-are-using-bliss-10x" class="md-nav__link">
767 If you are using Bliss 10.x
768 </a>
769
770</li>
771
772 <li class="md-nav__item">
773 <a href="#part-5-creating-the-data-image" class="md-nav__link">
774 Part 5 - Creating the data image
775 </a>
776
777</li>
778
779 </ul>
780 </nav>
781
782</li>
783
784 <li class="md-nav__item">
785 <a href="#custom-install-bliss-os-8x10x11x-uefiesp-64-bit" class="md-nav__link">
786 Custom Install - Bliss OS 8.x/10.x/11.x UEFI/ESP (64-bit)
787 </a>
788
789 <nav class="md-nav">
790 <ul class="md-nav__list">
791
792 <li class="md-nav__item">
793 <a href="#part-1-mounting-your-uefiesp-partition" class="md-nav__link">
794 Part 1 - Mounting Your UEFI/ESP Partition
795 </a>
796
797 <nav class="md-nav">
798 <ul class="md-nav__list">
799
800 <li class="md-nav__item">
801 <a href="#cmd-is-not-showing-up-what-should-i-do" class="md-nav__link">
802 cmd is not showing up, what should I do?
803 </a>
804
805</li>
806
807 </ul>
808 </nav>
809
810</li>
811
812 <li class="md-nav__item">
813 <a href="#part-1-alternate-esp-setup" class="md-nav__link">
814 Part 1 (alternate) - ESP setup
815 </a>
816
817</li>
818
819 <li class="md-nav__item">
820 <a href="#part-1-alternate-killing-the-explorerexe" class="md-nav__link">
821 Part 1 (alternate) - Killing the explorer.exe
822 </a>
823
824</li>
825
826 </ul>
827 </nav>
828
829</li>
830
831 <li class="md-nav__item">
832 <a href="#part-2-uefi-installation" class="md-nav__link">
833 Part 2 - UEFI installation
834 </a>
835
836 <nav class="md-nav">
837 <ul class="md-nav__list">
838
839 <li class="md-nav__item">
840 <a href="#part-4-the-manual-blissification-of-your-pc" class="md-nav__link">
841 Part 4 - The Manual Blissification of Your PC
842 </a>
843
844</li>
845
846 </ul>
847 </nav>
848
849</li>
850
851 <li class="md-nav__item">
852 <a href="#install-bliss-os-on-a-vm-virtualbox" class="md-nav__link">
853 Install Bliss OS on a VM (virtualbox)
854 </a>
855
856</li>
857
858
859
860
861
862 </ul>
863
864</nav>
865 </div>
866 </div>
867 </div>
868
869
870 <div class="md-content">
871 <article class="md-content__inner md-typeset">
872
873
874
875 <h1 id="installation-guide-misc">Installation Guide (Misc)</h1>
876<p>This is only for <strong>advanced users</strong>. For regular users, please visit our main <a href="../installation-guide/">Installation Guide found here.</a></p>
877<h2 id="windows-based-installer-uefiesp-64-bit">Windows-based installer - UEFI/ESP (64-bit)</h2>
878<p>This method is <strong>no longer supported</strong> due to too many people not understanding computer basics and breaking things. <strong>Proceed at your own risk.</strong> This method might be the easiest currently if you understand what you are doing.</p>
879<p>For the overall instructions on using this method, please refer to the <a href="https://forum.xda-developers.com/android/software/winapp-android-x86-installer-uefi-t3222483">tool's original thread</a>. The tools have been updated by Team Bliss for easy installation on UEFI/ESP machines. The <a href="https://github.com/BlissRoms-x86/Androidx86-Installer-for-Windows/tree/master/bin">builds we produce can be found here.</a> And the <a href="https://github.com/BlissRoms-x86/Androidx86-Installer-for-Windows">source for those builds can be found here.</a> This tool should work on Remix OS as well, but this has not been tested yet.</p>
880<h3 id="part-1-using-the-installer">Part 1 - Using the Installer</h3>
881<p>The installer has been updated to accept the <code>.iso</code> files for our 8.x/10.x/11.x releases. Just follow the prompts the installer gives. Refer to the original thread for any questions, and please search before asking.</p>
882<p>If you plan on using root, the process will require you to manually extract the system.img from within the system.sfs file. Then you must delete the system.sfs file after extracting. </p>
883<p><strong>Warning</strong> - for Pie, you will need to add <code>androidboot.hardware=android_x86_64</code> to the grub entry in order to boot!</p>
884<h3 id="part-2-switching-the-uefiefi-boot-entry">Part 2 - Switching the UEFI/EFI boot entry</h3>
885<p>Option one is to use the EasyUEFI tool, then switch the UEFI/EFI entry it created to boot first. Close and reboot. Option two is to use your BIOS to select the added UEFI boot entry.</p>
886<h2 id="use-syslinux-efi-to-run-bliss-os-7x10x11x">Use syslinux EFI to run Bliss OS 7.x/10.x/11.x</h2>
887<p>Thanks to @IcedCube for the original post! This method is <strong>NOT recommended</strong> as it is fairly bleeding-edge and experimental, but it should help booting on Chinese tablets that do not want to run <code>grub</code>.</p>
888<p>Use a Linux installation for the following procedure.</p>
889<h3 id="part-1-grab-the-required-tools">Part 1 - Grab the required tools</h3>
890<p>Install <code>unsquashfs</code> (part of <code>squashfs-tools</code>).</p>
891<h3 id="part-2-get-bliss-os">Part 2 - Get Bliss OS</h3>
892<p>Grab the latest build of Bliss OS 7.x/10.x/11.x.</p>
893<h3 id="part-3-get-the-syslinux-efi-bootstrap">Part 3 - Get the syslinux EFI bootstrap</h3>
894<p><a href="https://forum.xda-developers.com/showpost.php?p=74977694&amp;postcount=1237">Grab the <code>.zip</code> file from @IcedCube's original post</a>, and extract it to the root of the USB drive. This will bootstrap syslinux EFI onto it.</p>
895<p>Then, make a folder called <code>android</code>.</p>
896<p>Now, open up the <code>.iso</code> in an archive program. Extract the following files form the root directory of the <code>.iso</code> image to the USB drive's <code>android</code> folder:</p>
897<ul>
898<li><code>initrd.img</code></li>
899<li><code>ramdisk.img</code></li>
900<li><code>kernel</code></li>
901</ul>
902<p>Extract <code>system.sfs</code> to a folder somewhere, such as <code>/tmp</code>.</p>
903<p>Open a terminal and change directory (using <code>cd</code>) to <code>/tmp</code>. Run <code>ls</code> and confirm that <code>system.sfs</code> is shown in the file list. If there is no output, start over as the file is misplaced.</p>
904<p>Run the following:</p>
905<p><code>unsquashfs ./system.sfs</code></p>
906<p>This will make a new directory called <code>squashfs_root</code>.</p>
907<h3 id="part-4-version-specific">Part 4 - Version specific</h3>
908<h4 id="if-you-are-using-bliss-7x">If you are using Bliss 7.x</h4>
909<p>Change directory to <code>squashfs_root</code> and run <code>ls</code>. There should only be one file - a <code>system.img</code> inside the directory. Copy the file to the USB's <code>android</code> folder.</p>
910<h3 id="if-you-are-using-bliss-10x">If you are using Bliss 10.x</h3>
911<p>Change directory to <code>squashfs_root</code>. The structure is a complete Android root filesystem. To install Bliss OS, the files will need to be in a system image. The following steps will guide you through creating a 2 GB <code>system.img</code> file, formatting it, mounting it, and copying the contents of <code>squashfs_root</code> into the new disk image.</p>
912<p>Execute:</p>
913<pre><code>mkdir /mnt/tempMount
914truncate /tmp/system.img --size=2G
915mkfs.ext4 -m0 /tmp/system.img
916sudo mount -o loop /tmp/system.img /mnt/tempMount
917sudo cp -prv /tmp/squashfs_root/* /mnt/tempMount/
918sync
919sudo umount /mnt/tempMount
920</code></pre>
921<p>The <code>sync</code> command might take some time.</p>
922<p>Now copy the <code>/tmp/system.img</code> file to your USB's Android folder.</p>
923<h3 id="part-5-creating-the-data-image">Part 5 - Creating the data image</h3>
924<p>First, find where your USB drive is mounted. It is usually in <code>/mnt</code> or <code>/media</code> (ex. <code>/media/USB</code>).</p>
925<p><code>cd</code> into the <code>android</code> folder.</p>
926<p>We will create a 3 GB data image file. You can attempt to create a 4 GB image but FAT32 maxes out at 4 GB per file. If your system supports exFAT or NTFS, you may try and use it.</p>
927<pre><code>truncate data.img --size=3G
928mkfs.ext4 -m0 data.img
929sync
930</code></pre>
931<p>This will be an completely empty <code>ext4</code> disk image, but will be enough to run Bliss.</p>
932<p>Finally, check to ensure everything is in structured like so:</p>
933<pre><code>&lt;ROOT&gt;
934- syslinux.cfg
935- android/
936-- kernel
937-- system.img
938-- data.img
939-- ramdisk.img
940-- initrd.img
941- EFI/
942-- BOOT/
943--- bootia32.efi
944--- bootx64.efi
945--- ldlinux.e32
946--- ldlinux.e64
947</code></pre>
948<p>Need to add some kernel parameters? Open <code>syslinux.cfg</code> and add them before the <code>initrd=/android/initrd.img</code> statement.</p>
949<p>Unmount the USB from your computer. Plug it into your device and use the BIOS to boot from your UEFI USB Drive, partition 1. If all goes well, you will get a black screen with small white text saying "Booting Android..." followed by loading files. You should get the Linux kernel text, then see the Bliss boot animation play after a couple minutes depending on your USB drive read/write speed.</p>
950<h2 id="custom-install-bliss-os-8x10x11x-uefiesp-64-bit">Custom Install - Bliss OS 8.x/10.x/11.x UEFI/ESP (64-bit)</h2>
951<p>Just as a reminder, Team Bliss is <strong>NOT</strong> responsible for any damage caused by this guide. By continuing, you automatically agree to these terms.</p>
952<h3 id="part-1-mounting-your-uefiesp-partition">Part 1 - Mounting Your UEFI/ESP Partition</h3>
953<p>You will want to make sure you can view hidden and system files in Explorer options. Once you do that, hit the start menu, and type in <code>cmd</code>. Once "Command Prompt" shows up, right click on it and choose "Open as administrator".</p>
954<h4 id="cmd-is-not-showing-up-what-should-i-do"><code>cmd</code> is not showing up, what should I do?</h4>
955<p>Press the Windows key and the R key to bring up the "Run..." dialog. Type in <code>cmd</code>, and then press Ctrl-Shift-Enter. Press "Yes" on the UAC popup.</p>
956<p>Run the following:</p>
957<pre><code>mountvol X: /S
958</code></pre>
959<p>Then check to see if it is mounted already. Run "Task Manager" by either</p>
960<ul>
961<li>Pressing Ctrl-Alt-Del and then clicking on "Task Manager", or</li>
962<li>Pressing Ctrl-Shift-Esc</li>
963</ul>
964<p>Click on "File", "Run new task", "Browse", "This computer", and SYSTEM (X or type in <code>X:</code> in the filepath bar. If you cannot access <code>X:</code>, then that could mean one of three things.</p>
965<ul>
966<li>You have an ESP setup (follow the installation method below)</li>
967<li>You have a legacy MBR setup</li>
968<li>Your setup has a custom boot sequence</li>
969</ul>
970<h3 id="part-1-alternate-esp-setup">Part 1 (alternate) - ESP setup</h3>
971<p>Windows 10 sometimes has an EFI partition already mounted under drive letter <code>Z:</code>, hidden. A very quick and easy way to access the ESP (EFI System Partition) in Windows 10 without using the command line is to start "Task Manager" (check above if you forgot the steps), and then click on "File", "Run new task", "Browse", "This computer", and SYSTEM (Z or type in <code>Z:</code> in the filepath bar).</p>
972<p>Now go to <code>boot/grub/grub.cfg</code> and edit it accordingly with Notepad++ or another text editor. Save the file and your're ready to go!</p>
973<h3 id="part-1-alternate-killing-the-explorerexe">Part 1 (alternate) - Killing the <code>explorer.exe</code></h3>
974<p>Run <code>cmd</code> as admin and enter the following command:</p>
975<pre><code>taskkill /im explorer.exe /f
976</code></pre>
977<p>This will kill the <code>explorer.exe</code> process - don't be surprised if it shows a warning. This step is sometimes required, because by default <code>explorer.exe</code> is ran by the currently logged in user, and it has to be run by the "Administrator" in order to view the mounted system drive. <strong>The "Administrator" account is not the same as an account with administrative privileges.</strong></p>
978<pre><code>mountvol X: /s
979</code></pre>
980<p>This will mount the system partition that usually consists of UEFI related files. <code>X:</code> is the letter of the drive - you can use whatever letter you want, but it has to be free for assignment. Then type:</p>
981<pre><code>explorer
982</code></pre>
983<p>This will run <code>explorer</code> as "Administrator" and will allow you to browse the mounted system partition.</p>
984<p>The above may not work for all devices, as some handle UEFI differently.</p>
985<h2 id="part-2-uefi-installation">Part 2 - UEFI installation</h2>
986<p>Let's start by downloading the required files. <a href="https://www.androidfilehost.com/?w=files&amp;flid=143191">Here is a customized UEFI boot for 32/64-bit machines.</a></p>
987<p>Please note that if you came from our Nougat builds to our Bliss OS 8.x builds, you will have to edit the <code>grub.cfga</code>.</p>
988<p>If you are using Bliss OS 8.x/10.x, please use the <code>grub</code> entry below as a guide:</p>
989<pre><code>menuentry 'Bliss-x86' --class android {
990 search --file --no-floppy --set=root /AndroidOS/system.sfs
991 linux /AndroidOS/kernel root=/dev/ram0 SRC=/AndroidOS androidboot.selinux=permissive androidboot.hardware=android_x86_64 quiet DATA=
992 initrd /AndroidOS/initrd.img
993}
994</code></pre>
995<p>If you are installing on <code>ext3</code>/<code>ext4</code>, due to a bug in the install you will have to use the following <code>grub</code> entry setup:</p>
996<pre><code>menuentry 'Bliss-x86' --class android {
997 search --file --no-floppy --set=root /AndroidOS/system.sfs
998 linux /AndroidOS/kernel root=/dev/ram0 SRC=/AndroidOS androidboot.selinux=permissive androidboot.hardware=android_x86_64 quiet DATA=
999 initrd /AndroidOS/initrd.img
1000}
1001</code></pre>
1002<p>Now that we have the partition mounted, we can copy that <code>BOOT</code> directory to your UEFI partition using <code>explorer</code> as the Administrator or by using the "New Task" dialog from Task Manager. (See above if you forgot the steps!) Once it is copied, go back to the Administrator <code>cmd</code> prompt and type:</p>
1003<pre><code>mountvol X: /D
1004</code></pre>
1005<p>or if you used <code>Z:</code>, type:</p>
1006<pre><code>mountvol Z: /D
1007</code></pre>
1008<p>This will dismount the UEFI/ESP volume for safe reboot. We then suggest you use EasyUEFI here to create the UEFI boot entry. Open the app, and create a new entry. Select your UEFI partition, and in the "File" Path, click "Browse" and use the file manager window to browse to your <code>BOOT/grub/grubx64.efi</code> file. Click OK, and then choose the new <code>grub</code> entry and move it to the top. Make sure Secure Boot is turned off or else it likely will just boot back to Windows.</p>
1009<h3 id="part-4-the-manual-blissification-of-your-pc">Part 4 - The Manual Blissification of Your PC</h3>
1010<p>To do a manual "Wubi like" install of Bliss OS after you install the UEFI entry, you will need to open the Bliss OS <code>.iso</code>/<code>.img</code> with 7zip, and then drag all the <code>.img</code> &amp; <code>.sfs</code> files to <code>C:/android-x86</code> or whatever your target drive is (make sure your <code>grub</code> entries match where you are putting these). Then create your <code>data.img</code>. We suggest using a tool like RMXtools (use version 1.7) from XDA to create it. Check the tool's thread for detailed instructions. You will want to create your <code>data.img</code> inside that <code>android-x86</code> folder.</p>
1011<p>You can now reboot if you have installed the custom UEFI entry right and selected it using EasyUEFI. You should boot right to the Android-x86 <code>grub</code> theme. There, you can use up and down to select, and return to boot that entry. You can also hit <code>e</code> to edit the selected entry. You will want to pay attention to which entry you select, since there will be one for <code>Bliss-x86(32bit)</code> and one or <code>Bliss-x86_64(64bit)</code>.</p>
1012<h2 id="install-bliss-os-on-a-vm-virtualbox">Install Bliss OS on a VM (virtualbox)</h2>
1013<p>This method is <strong>incomplete</strong>, a <strong>work-in-progress</strong>. Android in general do not run great in VMs, because they do not have the proper drivers. As such performance is greatly reduced if you use this method. Please only install Bliss OS in VMs for evaluation, and keep in mind that the performance exhibited by Bliss OS in such an environment is not a true representation of actual performance on bare metal. With that in mind, let's get started!</p>
1014<p>First, make sure your CPU is capable of running VMs. For Intel, it is usually Intel VT-x and VT-d. For AMD, it is usually AMD-V. You may also need IOMMU support, although it is probably not necessary since you won't be passing through GPUs.</p>
1015<p>Download the latest Bliss OS <code>.iso</code> from our website. Then, download the latest version of VirtualBox, and the latest VirtualBox <strong>extension pack</strong>. Install both executables.</p>
1016<p>Once inside VirtualBox, click on "New." For the name, type "Bliss OS." For the type, select <code>Linux</code>, and then <code>Linux 2.6 / 3.x / 4.x (64-bit)</code> for the version. Set memory size to 2048 MB (2 GB) or more. For the disk, accept the default options for the disk type. For the size, set it to 20 GB. VirtualBox should initialize a new virtual machine.</p>
1017<p>We need to tweak a couple more settings. Click on "Settings" on the top bar. Allocate more logical processors in System &gt; Processor. Drag the slider to the right, keeping it <strong>inside</strong> the green bar, as you want to leave a couple of logical processors for the host operating system. For the display, try allocating all of the VRAM. (128 MB most likely) Enable 3D Acceleration. Click OK to save settings.</p>
1018<p>Now click on Start. VirtualBox will ask you for the CD image. Click on the folder with the green up arrow, and then select the ISO you downloaded earlier.</p>
1019<p>Select "Installation - Install Bliss-OS to harddisk" Press D to detect devices. Press C to create and modify partitions. If asked, select No for GPT. Select New, Primary, full size, and then make it bootable. Write to disk. Quit. Select the partition and then reformat to ext4. Select Yes to install GRUB. Select Yes to make the /system directory writable.</p>
1020<p>At this point the installation should be complete. But when you reboot, you will notice that the screen is completely black with a cursor at the top-left. This is because there is no display drivers for the virtual machine. Reset the instance, edit the boot parameters, and add <code>nomodeset</code> to the end. Bliss OS should then boot fully.</p>
1021<p>Congratulations! You should have a fully working Bliss OS install in a VM, or at least something that works... even if it may be slow. Again, Android on VM is generally not a good idea and you will get a lot more performance if you install Bliss OS to the actual hardware.</p>
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031 </article>
1032 </div>
1033 </div>
1034 </main>
1035
1036
1037<footer class="md-footer">
1038
1039 <div class="md-footer-nav">
1040 <nav class="md-footer-nav__inner md-grid">
1041
1042 <a href="../extras/" title="Extras" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev">
1043 <div class="md-flex__cell md-flex__cell--shrink">
1044 <i class="md-icon md-icon--arrow-back md-footer-nav__button"></i>
1045 </div>
1046 <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
1047 <span class="md-flex__ellipsis">
1048 <span class="md-footer-nav__direction">
1049 Previous
1050 </span>
1051 Extras
1052 </span>
1053 </div>
1054 </a>
1055
1056
1057 <a href="../installation-guide-surface-devices/" title="Installation Guide (Surface devices)" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next">
1058 <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
1059 <span class="md-flex__ellipsis">
1060 <span class="md-footer-nav__direction">
1061 Next
1062 </span>
1063 Installation Guide (Surface devices)
1064 </span>
1065 </div>
1066 <div class="md-flex__cell md-flex__cell--shrink">
1067 <i class="md-icon md-icon--arrow-forward md-footer-nav__button"></i>
1068 </div>
1069 </a>
1070
1071 </nav>
1072 </div>
1073
1074 <div class="md-footer-meta md-typeset">
1075 <div class="md-footer-meta__inner md-grid">
1076 <div class="md-footer-copyright">
1077
1078 powered by
1079 <a href="https://www.mkdocs.org">MkDocs</a>
1080 and
1081 <a href="https://squidfunk.github.io/mkdocs-material/">
1082 Material for MkDocs</a>
1083 </div>
1084
1085 </div>
1086 </div>
1087</footer>
1088
1089 </div>
1090
1091 <script src="../../assets/javascripts/application.ac79c3b0.js"></script>
1092
1093 <script>app.initialize({version:"1.0.4",url:{base:"../.."}})</script>
1094
1095
1096 </body>
1097</html>