Gitiles
Code Review Sign In
review.blissroms.org / Documentation-release / d09b00ec1eb7b950785adae7b1f90f8628b275c0 / . / Bliss OS / installation-guide-misc / index.html
blob: 1926febe87043b909990e7fef1e5320a92a7c16a [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">
478 <a href="../troubleshooting/" title="Troubleshooting" class="md-nav__link">
479 Troubleshooting
480 </a>
481 </li>
482
483
484 </ul>
485 </nav>
486 </li>
487
488
489
490
491
492
493
494 <li class="md-nav__item md-nav__item--nested">
495
496 <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3" type="checkbox" id="nav-3">
497
498 <label class="md-nav__link" for="nav-3">
499 BlissRoms
500 </label>
501 <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
502 <label class="md-nav__title" for="nav-3">
503 BlissRoms
504 </label>
505 <ul class="md-nav__list" data-md-scrollfix>
506
507
508
509
510
511
512
513 <li class="md-nav__item">
514 <a href="../../BlissRoms/" title="Index" class="md-nav__link">
515 Index
516 </a>
517 </li>
518
519
520
521
522
523
524
525 <li class="md-nav__item">
526 <a href="../../BlissRoms/build-guide/" title="Build Guide" class="md-nav__link">
527 Build Guide
528 </a>
529 </li>
530
531
532
533
534
535
536
537 <li class="md-nav__item">
538 <a href="../../BlissRoms/build-tips/" title="Build Tips" class="md-nav__link">
539 Build Tips
540 </a>
541 </li>
542
543
544 </ul>
545 </nav>
546 </li>
547
548
549
550
551
552
553
554 <li class="md-nav__item md-nav__item--nested">
555
556 <input class="md-toggle md-nav__toggle" data-md-toggle="nav-4" type="checkbox" id="nav-4">
557
558 <label class="md-nav__link" for="nav-4">
559 Common
560 </label>
561 <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
562 <label class="md-nav__title" for="nav-4">
563 Common
564 </label>
565 <ul class="md-nav__list" data-md-scrollfix>
566
567
568
569
570
571
572
573 <li class="md-nav__item">
574 <a href="../../common/" title="Index" class="md-nav__link">
575 Index
576 </a>
577 </li>
578
579
580
581
582
583
584
585 <li class="md-nav__item">
586 <a href="../../common/git-started/" title="Git Started" class="md-nav__link">
587 Git Started
588 </a>
589 </li>
590
591
592
593
594
595
596
597 <li class="md-nav__item">
598 <a href="../../common/maintaining-proper-authorship/" title="Maintaining proper authorship" class="md-nav__link">
599 Maintaining proper authorship
600 </a>
601 </li>
602
603
604
605
606
607
608
609 <li class="md-nav__item">
610 <a href="../../common/using-dippy-bird/" title="Using `dippy-bird`" class="md-nav__link">
611 Using `dippy-bird`
612 </a>
613 </li>
614
615
616 </ul>
617 </nav>
618 </li>
619
620
621
622
623
624
625
626 <li class="md-nav__item md-nav__item--nested">
627
628 <input class="md-toggle md-nav__toggle" data-md-toggle="nav-5" type="checkbox" id="nav-5">
629
630 <label class="md-nav__link" for="nav-5">
631 Infrastructure
632 </label>
633 <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
634 <label class="md-nav__title" for="nav-5">
635 Infrastructure
636 </label>
637 <ul class="md-nav__list" data-md-scrollfix>
638
639
640
641
642
643
644
645 <li class="md-nav__item">
646 <a href="../../infrastructure/" title="Index" class="md-nav__link">
647 Index
648 </a>
649 </li>
650
651
652 </ul>
653 </nav>
654 </li>
655
656
657 </ul>
658</nav>
659 </div>
660 </div>
661 </div>
662
663
664 <div class="md-sidebar md-sidebar--secondary" data-md-component="toc">
665 <div class="md-sidebar__scrollwrap">
666 <div class="md-sidebar__inner">
667
668<nav class="md-nav md-nav--secondary">
669
670
671
672
673
674 <label class="md-nav__title" for="__toc">Table of contents</label>
675 <ul class="md-nav__list" data-md-scrollfix>
676
677 <li class="md-nav__item">
678 <a href="#windows-based-installer-uefiesp-64-bit" class="md-nav__link">
679 Windows-based installer - UEFI/ESP (64-bit)
680 </a>
681
682 <nav class="md-nav">
683 <ul class="md-nav__list">
684
685 <li class="md-nav__item">
686 <a href="#part-1-using-the-installer" class="md-nav__link">
687 Part 1 - Using the Installer
688 </a>
689
690</li>
691
692 <li class="md-nav__item">
693 <a href="#part-2-switching-the-uefiefi-boot-entry" class="md-nav__link">
694 Part 2 - Switching the UEFI/EFI boot entry
695 </a>
696
697</li>
698
699 </ul>
700 </nav>
701
702</li>
703
704 <li class="md-nav__item">
705 <a href="#use-syslinux-efi-to-run-bliss-os-7x10x11x" class="md-nav__link">
706 Use syslinux EFI to run Bliss OS 7.x/10.x/11.x
707 </a>
708
709 <nav class="md-nav">
710 <ul class="md-nav__list">
711
712 <li class="md-nav__item">
713 <a href="#part-1-grab-the-required-tools" class="md-nav__link">
714 Part 1 - Grab the required tools
715 </a>
716
717</li>
718
719 <li class="md-nav__item">
720 <a href="#part-2-get-bliss-os" class="md-nav__link">
721 Part 2 - Get Bliss OS
722 </a>
723
724</li>
725
726 <li class="md-nav__item">
727 <a href="#part-3-get-the-syslinux-efi-bootstrap" class="md-nav__link">
728 Part 3 - Get the syslinux EFI bootstrap
729 </a>
730
731</li>
732
733 <li class="md-nav__item">
734 <a href="#part-4-version-specific" class="md-nav__link">
735 Part 4 - Version specific
736 </a>
737
738 <nav class="md-nav">
739 <ul class="md-nav__list">
740
741 <li class="md-nav__item">
742 <a href="#if-you-are-using-bliss-7x" class="md-nav__link">
743 If you are using Bliss 7.x
744 </a>
745
746</li>
747
748 </ul>
749 </nav>
750
751</li>
752
753 <li class="md-nav__item">
754 <a href="#if-you-are-using-bliss-10x" class="md-nav__link">
755 If you are using Bliss 10.x
756 </a>
757
758</li>
759
760 <li class="md-nav__item">
761 <a href="#part-5-creating-the-data-image" class="md-nav__link">
762 Part 5 - Creating the data image
763 </a>
764
765</li>
766
767 </ul>
768 </nav>
769
770</li>
771
772 <li class="md-nav__item">
773 <a href="#custom-install-bliss-os-8x10x11x-uefiesp-64-bit" class="md-nav__link">
774 Custom Install - Bliss OS 8.x/10.x/11.x UEFI/ESP (64-bit)
775 </a>
776
777 <nav class="md-nav">
778 <ul class="md-nav__list">
779
780 <li class="md-nav__item">
781 <a href="#part-1-mounting-your-uefiesp-partition" class="md-nav__link">
782 Part 1 - Mounting Your UEFI/ESP Partition
783 </a>
784
785 <nav class="md-nav">
786 <ul class="md-nav__list">
787
788 <li class="md-nav__item">
789 <a href="#cmd-is-not-showing-up-what-should-i-do" class="md-nav__link">
790 cmd is not showing up, what should I do?
791 </a>
792
793</li>
794
795 </ul>
796 </nav>
797
798</li>
799
800 <li class="md-nav__item">
801 <a href="#part-1-alternate-esp-setup" class="md-nav__link">
802 Part 1 (alternate) - ESP setup
803 </a>
804
805</li>
806
807 <li class="md-nav__item">
808 <a href="#part-1-alternate-killing-the-explorerexe" class="md-nav__link">
809 Part 1 (alternate) - Killing the explorer.exe
810 </a>
811
812</li>
813
814 </ul>
815 </nav>
816
817</li>
818
819 <li class="md-nav__item">
820 <a href="#part-2-uefi-installation" class="md-nav__link">
821 Part 2 - UEFI installation
822 </a>
823
824 <nav class="md-nav">
825 <ul class="md-nav__list">
826
827 <li class="md-nav__item">
828 <a href="#part-4-the-manual-blissification-of-your-pc" class="md-nav__link">
829 Part 4 - The Manual Blissification of Your PC
830 </a>
831
832</li>
833
834 </ul>
835 </nav>
836
837</li>
838
839 <li class="md-nav__item">
840 <a href="#install-bliss-os-on-a-vm-virtualbox" class="md-nav__link">
841 Install Bliss OS on a VM (virtualbox)
842 </a>
843
844</li>
845
846
847
848
849
850 </ul>
851
852</nav>
853 </div>
854 </div>
855 </div>
856
857
858 <div class="md-content">
859 <article class="md-content__inner md-typeset">
860
861
862
863 <h1 id="installation-guide-misc">Installation Guide (Misc)</h1>
864<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>
865<h2 id="windows-based-installer-uefiesp-64-bit">Windows-based installer - UEFI/ESP (64-bit)</h2>
866<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>
867<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>
868<h3 id="part-1-using-the-installer">Part 1 - Using the Installer</h3>
869<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>
870<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>
871<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>
872<h3 id="part-2-switching-the-uefiefi-boot-entry">Part 2 - Switching the UEFI/EFI boot entry</h3>
873<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>
874<h2 id="use-syslinux-efi-to-run-bliss-os-7x10x11x">Use syslinux EFI to run Bliss OS 7.x/10.x/11.x</h2>
875<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>
876<p>Use a Linux installation for the following procedure.</p>
877<h3 id="part-1-grab-the-required-tools">Part 1 - Grab the required tools</h3>
878<p>Install <code>unsquashfs</code> (part of <code>squashfs-tools</code>).</p>
879<h3 id="part-2-get-bliss-os">Part 2 - Get Bliss OS</h3>
880<p>Grab the latest build of Bliss OS 7.x/10.x/11.x.</p>
881<h3 id="part-3-get-the-syslinux-efi-bootstrap">Part 3 - Get the syslinux EFI bootstrap</h3>
882<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>
883<p>Then, make a folder called <code>android</code>.</p>
884<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>
885<ul>
886<li><code>initrd.img</code></li>
887<li><code>ramdisk.img</code></li>
888<li><code>kernel</code></li>
889</ul>
890<p>Extract <code>system.sfs</code> to a folder somewhere, such as <code>/tmp</code>.</p>
891<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>
892<p>Run the following:</p>
893<p><code>unsquashfs ./system.sfs</code></p>
894<p>This will make a new directory called <code>squashfs_root</code>.</p>
895<h3 id="part-4-version-specific">Part 4 - Version specific</h3>
896<h4 id="if-you-are-using-bliss-7x">If you are using Bliss 7.x</h4>
897<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>
898<h3 id="if-you-are-using-bliss-10x">If you are using Bliss 10.x</h3>
899<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>
900<p>Execute:</p>
901<pre><code>mkdir /mnt/tempMount
902truncate /tmp/system.img --size=2G
903mkfs.ext4 -m0 /tmp/system.img
904sudo mount -o loop /tmp/system.img /mnt/tempMount
905sudo cp -prv /tmp/squashfs_root/* /mnt/tempMount/
906sync
907sudo umount /mnt/tempMount
908</code></pre>
909<p>The <code>sync</code> command might take some time.</p>
910<p>Now copy the <code>/tmp/system.img</code> file to your USB's Android folder.</p>
911<h3 id="part-5-creating-the-data-image">Part 5 - Creating the data image</h3>
912<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>
913<p><code>cd</code> into the <code>android</code> folder.</p>
914<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>
915<pre><code>truncate data.img --size=3G
916mkfs.ext4 -m0 data.img
917sync
918</code></pre>
919<p>This will be an completely empty <code>ext4</code> disk image, but will be enough to run Bliss.</p>
920<p>Finally, check to ensure everything is in structured like so:</p>
921<pre><code>&lt;ROOT&gt;
922- syslinux.cfg
923- android/
924-- kernel
925-- system.img
926-- data.img
927-- ramdisk.img
928-- initrd.img
929- EFI/
930-- BOOT/
931--- bootia32.efi
932--- bootx64.efi
933--- ldlinux.e32
934--- ldlinux.e64
935</code></pre>
936<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>
937<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>
938<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>
939<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>
940<h3 id="part-1-mounting-your-uefiesp-partition">Part 1 - Mounting Your UEFI/ESP Partition</h3>
941<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>
942<h4 id="cmd-is-not-showing-up-what-should-i-do"><code>cmd</code> is not showing up, what should I do?</h4>
943<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>
944<p>Run the following:</p>
945<pre><code>mountvol X: /S
946</code></pre>
947<p>Then check to see if it is mounted already. Run "Task Manager" by either</p>
948<ul>
949<li>Pressing Ctrl-Alt-Del and then clicking on "Task Manager", or</li>
950<li>Pressing Ctrl-Shift-Esc</li>
951</ul>
952<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>
953<ul>
954<li>You have an ESP setup (follow the installation method below)</li>
955<li>You have a legacy MBR setup</li>
956<li>Your setup has a custom boot sequence</li>
957</ul>
958<h3 id="part-1-alternate-esp-setup">Part 1 (alternate) - ESP setup</h3>
959<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>
960<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>
961<h3 id="part-1-alternate-killing-the-explorerexe">Part 1 (alternate) - Killing the <code>explorer.exe</code></h3>
962<p>Run <code>cmd</code> as admin and enter the following command:</p>
963<pre><code>taskkill /im explorer.exe /f
964</code></pre>
965<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>
966<pre><code>mountvol X: /s
967</code></pre>
968<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>
969<pre><code>explorer
970</code></pre>
971<p>This will run <code>explorer</code> as "Administrator" and will allow you to browse the mounted system partition.</p>
972<p>The above may not work for all devices, as some handle UEFI differently.</p>
973<h2 id="part-2-uefi-installation">Part 2 - UEFI installation</h2>
974<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>
975<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>
976<p>If you are using Bliss OS 8.x/10.x, please use the <code>grub</code> entry below as a guide:</p>
977<pre><code>menuentry 'Bliss-x86' --class android {
978 search --file --no-floppy --set=root /AndroidOS/system.sfs
979 linux /AndroidOS/kernel root=/dev/ram0 SRC=/AndroidOS androidboot.selinux=permissive androidboot.hardware=android_x86_64 quiet DATA=
980 initrd /AndroidOS/initrd.img
981}
982</code></pre>
983<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>
984<pre><code>menuentry 'Bliss-x86' --class android {
985 search --file --no-floppy --set=root /AndroidOS/system.sfs
986 linux /AndroidOS/kernel root=/dev/ram0 SRC=/AndroidOS androidboot.selinux=permissive androidboot.hardware=android_x86_64 quiet DATA=
987 initrd /AndroidOS/initrd.img
988}
989</code></pre>
990<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>
991<pre><code>mountvol X: /D
992</code></pre>
993<p>or if you used <code>Z:</code>, type:</p>
994<pre><code>mountvol Z: /D
995</code></pre>
996<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>
997<h3 id="part-4-the-manual-blissification-of-your-pc">Part 4 - The Manual Blissification of Your PC</h3>
998<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>
999<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>
1000<h2 id="install-bliss-os-on-a-vm-virtualbox">Install Bliss OS on a VM (virtualbox)</h2>
1001<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>
1002<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>
1003<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>
1004<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>
1005<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>
1006<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>
1007<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>
1008<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>
1009<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>
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019 </article>
1020 </div>
1021 </div>
1022 </main>
1023
1024
1025<footer class="md-footer">
1026
1027 <div class="md-footer-nav">
1028 <nav class="md-footer-nav__inner md-grid">
1029
1030 <a href="../extras/" title="Extras" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev">
1031 <div class="md-flex__cell md-flex__cell--shrink">
1032 <i class="md-icon md-icon--arrow-back md-footer-nav__button"></i>
1033 </div>
1034 <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
1035 <span class="md-flex__ellipsis">
1036 <span class="md-footer-nav__direction">
1037 Previous
1038 </span>
1039 Extras
1040 </span>
1041 </div>
1042 </a>
1043
1044
1045 <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">
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 Next
1050 </span>
1051 Installation Guide (Surface devices)
1052 </span>
1053 </div>
1054 <div class="md-flex__cell md-flex__cell--shrink">
1055 <i class="md-icon md-icon--arrow-forward md-footer-nav__button"></i>
1056 </div>
1057 </a>
1058
1059 </nav>
1060 </div>
1061
1062 <div class="md-footer-meta md-typeset">
1063 <div class="md-footer-meta__inner md-grid">
1064 <div class="md-footer-copyright">
1065
1066 powered by
1067 <a href="https://www.mkdocs.org">MkDocs</a>
1068 and
1069 <a href="https://squidfunk.github.io/mkdocs-material/">
1070 Material for MkDocs</a>
1071 </div>
1072
1073 </div>
1074 </div>
1075</footer>
1076
1077 </div>
1078
1079 <script src="../../assets/javascripts/application.ac79c3b0.js"></script>
1080
1081 <script>app.initialize({version:"1.0.4",url:{base:"../.."}})</script>
1082
1083
1084 </body>
1085</html>