Gitiles
Code Review Sign In
review.blissroms.org / Documentation-release / 45174cac598902ea298c79b0b9618f70545bcc72 / . / Bliss OS / installation-guide / index.html
blob: 9f43a5fbe129781337fa634641262b686ab4214f [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
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
252 </label>
253
254 <a href="./" title="Installation Guide" class="md-nav__link md-nav__link--active">
255 Installation Guide
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">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]269 <a href="#preface" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]270 Preface
271 </a>
272
273</li>
274
275 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]276 <a href="#warning" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]277 Warning!
278 </a>
279
280</li>
281
282 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]283 <a href="#bootable-installation-method-mbruefiesp-3264-bit" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]284 Bootable installation method - MBR/UEFI/ESP (32/64-bit)
285 </a>
286
287 <nav class="md-nav">
288 <ul class="md-nav__list">
289
290 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]291 <a href="#part-1-gather-your-tools" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]292 Part 1 - Gather Your Tools
293 </a>
294
295</li>
296
297 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]298 <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]299 Part 2 - Flashing Bliss OS to the USB drive
300 </a>
301
302</li>
303
304 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]305 <a href="#part-3-testing-bliss-os-on-your-system" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]306 Part 3 - Testing Bliss OS on your system
307 </a>
308
309 <nav class="md-nav">
310 <ul class="md-nav__list">
311
312 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]313 <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]314 Troubleshooting - Booting from the USB kicks me back to BIOS, or back to my Windows/macOS/Linux installation.
315 </a>
316
317</li>
318
319 </ul>
320 </nav>
321
322</li>
323
324 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]325 <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]326 Part 3 (alternate) - Using Bliss OS from your USB drive
327 </a>
328
329</li>
330
331 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]332 <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]333 Part 4 - Setting up and Installing Bliss OS on your HDD/SSD/SD card
334 </a>
335
336</li>
337
338 </ul>
339 </nav>
340
341</li>
342
343 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]344 <a href="#windows-based-installer-uefiesp-64-bit" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]345 Windows-based installer - UEFI/ESP (64-bit)
346 </a>
347
348 <nav class="md-nav">
349 <ul class="md-nav__list">
350
351 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]352 <a href="#part-1-using-the-installer" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]353 Part 1 - Using the Installer
354 </a>
355
356</li>
357
358 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]359 <a href="#part-2-switching-the-uefiefi-boot-entry" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]360 Part 2 - Switching the UEFI/EFI boot entry
361 </a>
362
363</li>
364
365 </ul>
366 </nav>
367
368</li>
369
370 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]371 <a href="#use-syslinux-efi-to-run-bliss-os-7x10x11x" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]372 Use syslinux EFI to run Bliss OS 7.x/10.x/11.x
373 </a>
374
375 <nav class="md-nav">
376 <ul class="md-nav__list">
377
378 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]379 <a href="#part-1-grab-the-required-tools" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]380 Part 1 - Grab the required tools
381 </a>
382
383</li>
384
385 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]386 <a href="#part-2-get-bliss-os" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]387 Part 2 - Get Bliss OS
388 </a>
389
390</li>
391
392 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]393 <a href="#part-3-get-the-syslinux-efi-bootstrap" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]394 Part 3 - Get the syslinux EFI bootstrap
395 </a>
396
397</li>
398
399 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]400 <a href="#part-4-version-specific" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]401 Part 4 - Version specific
402 </a>
403
404 <nav class="md-nav">
405 <ul class="md-nav__list">
406
407 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]408 <a href="#if-you-are-using-bliss-7x" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]409 If you are using Bliss 7.x
410 </a>
411
412</li>
413
414 </ul>
415 </nav>
416
417</li>
418
419 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]420 <a href="#if-you-are-using-bliss-10x" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]421 If you are using Bliss 10.x
422 </a>
423
424</li>
425
426 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]427 <a href="#part-5-creating-the-data-image" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]428 Part 5 - Creating the data image
429 </a>
430
431</li>
432
433 </ul>
434 </nav>
435
436</li>
437
438 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]439 <a href="#custom-install-bliss-os-8x10x11x-uefiesp-64-bit" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]440 Custom Install - Bliss OS 8.x/10.x/11.x UEFI/ESP (64-bit)
441 </a>
442
443 <nav class="md-nav">
444 <ul class="md-nav__list">
445
446 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]447 <a href="#part-1-mounting-your-uefiesp-partition" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]448 Part 1 - Mounting Your UEFI/ESP Partition
449 </a>
450
451 <nav class="md-nav">
452 <ul class="md-nav__list">
453
454 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]455 <a href="#cmd-is-not-showing-up-what-should-i-do" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]456 cmd is not showing up, what should I do?
457 </a>
458
459</li>
460
461 </ul>
462 </nav>
463
464</li>
465
466 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]467 <a href="#part-1-alternate-esp-setup" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]468 Part 1 (alternate) - ESP setup
469 </a>
470
471</li>
472
473 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]474 <a href="#part-1-alternate-killing-the-explorerexe" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]475 Part 1 (alternate) - Killing the explorer.exe
476 </a>
477
478</li>
479
480 </ul>
481 </nav>
482
483</li>
484
485 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]486 <a href="#part-2-uefi-installation" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]487 Part 2 - UEFI installation
488 </a>
489
490 <nav class="md-nav">
491 <ul class="md-nav__list">
492
493 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]494 <a href="#part-4-the-manual-blissification-of-your-pc" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]495 Part 4 - The Manual Blissification of Your PC
496 </a>
497
498</li>
499
500 </ul>
501 </nav>
502
503</li>
504
505 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]506 <a href="#install-bliss-os-on-a-vm-virtualbox" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]507 Install Bliss OS on a VM (virtualbox)
508 </a>
509
510</li>
511
512 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]513 <a href="#specific-surface-model-instructions" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]514 Specific Surface model instructions
515 </a>
516
517</li>
518
519 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]520 <a href="#conclusion" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]521 Conclusion
522 </a>
523
524</li>
525
526
527
528
529
530 </ul>
531
532</nav>
533
534 </li>
535
536
537
538
539
540
541
542 <li class="md-nav__item">
543 <a href="../troubleshooting/" title="Troubleshooting" class="md-nav__link">
544 Troubleshooting
545 </a>
546 </li>
547
548
549 </ul>
550 </nav>
551 </li>
552
553
554
555
556
557
558
559 <li class="md-nav__item md-nav__item--nested">
560
561 <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3" type="checkbox" id="nav-3">
562
563 <label class="md-nav__link" for="nav-3">
564 BlissRoms
565 </label>
566 <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
567 <label class="md-nav__title" for="nav-3">
568 BlissRoms
569 </label>
570 <ul class="md-nav__list" data-md-scrollfix>
571
572
573
574
575
576
577
578 <li class="md-nav__item">
579 <a href="../../BlissRoms/" title="Index" class="md-nav__link">
580 Index
581 </a>
582 </li>
583
584
585
586
587
588
589
590 <li class="md-nav__item">
591 <a href="../../BlissRoms/build-guide/" title="Build Guide" class="md-nav__link">
592 Build Guide
593 </a>
594 </li>
595
596
597
598
599
600
601
602 <li class="md-nav__item">
603 <a href="../../BlissRoms/build-tips/" title="Build Tips" class="md-nav__link">
604 Build Tips
605 </a>
606 </li>
607
608
609 </ul>
610 </nav>
611 </li>
612
613
614
615
616
617
618
619 <li class="md-nav__item md-nav__item--nested">
620
621 <input class="md-toggle md-nav__toggle" data-md-toggle="nav-4" type="checkbox" id="nav-4">
622
623 <label class="md-nav__link" for="nav-4">
624 Common
625 </label>
626 <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
627 <label class="md-nav__title" for="nav-4">
628 Common
629 </label>
630 <ul class="md-nav__list" data-md-scrollfix>
631
632
633
634
635
636
637
638 <li class="md-nav__item">
639 <a href="../../common/" title="Index" class="md-nav__link">
640 Index
641 </a>
642 </li>
643
644
645
646
647
648
649
650 <li class="md-nav__item">
651 <a href="../../common/git-started/" title="Git Started" class="md-nav__link">
652 Git Started
653 </a>
654 </li>
655
656
657
658
659
660
661
662 <li class="md-nav__item">
Eric Park8584eda2019-09-02 09:45:55 +0800[diff] [blame]663 <a href="../../common/maintaining-proper-authorship/" title="Maintaining proper authorship" class="md-nav__link">
664 Maintaining proper authorship
665 </a>
666 </li>
667
668
669
670
671
672
673
674 <li class="md-nav__item">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]675 <a href="../../common/using-dippy-bird/" title="Using `dippy-bird`" class="md-nav__link">
676 Using `dippy-bird`
677 </a>
678 </li>
679
680
681 </ul>
682 </nav>
683 </li>
684
685
686
687
688
689
690
691 <li class="md-nav__item md-nav__item--nested">
692
693 <input class="md-toggle md-nav__toggle" data-md-toggle="nav-5" type="checkbox" id="nav-5">
694
695 <label class="md-nav__link" for="nav-5">
696 Infrastructure
697 </label>
698 <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
699 <label class="md-nav__title" for="nav-5">
700 Infrastructure
701 </label>
702 <ul class="md-nav__list" data-md-scrollfix>
703
704
705
706
707
708
709
710 <li class="md-nav__item">
711 <a href="../../infrastructure/" title="Index" class="md-nav__link">
712 Index
713 </a>
714 </li>
715
716
717 </ul>
718 </nav>
719 </li>
720
721
722 </ul>
723</nav>
724 </div>
725 </div>
726 </div>
727
728
729 <div class="md-sidebar md-sidebar--secondary" data-md-component="toc">
730 <div class="md-sidebar__scrollwrap">
731 <div class="md-sidebar__inner">
732
733<nav class="md-nav md-nav--secondary">
734
735
736
737
738
739 <label class="md-nav__title" for="__toc">Table of contents</label>
740 <ul class="md-nav__list" data-md-scrollfix>
741
742 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]743 <a href="#preface" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]744 Preface
745 </a>
746
747</li>
748
749 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]750 <a href="#warning" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]751 Warning!
752 </a>
753
754</li>
755
756 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]757 <a href="#bootable-installation-method-mbruefiesp-3264-bit" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]758 Bootable installation method - MBR/UEFI/ESP (32/64-bit)
759 </a>
760
761 <nav class="md-nav">
762 <ul class="md-nav__list">
763
764 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]765 <a href="#part-1-gather-your-tools" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]766 Part 1 - Gather Your Tools
767 </a>
768
769</li>
770
771 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]772 <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]773 Part 2 - Flashing Bliss OS to the USB drive
774 </a>
775
776</li>
777
778 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]779 <a href="#part-3-testing-bliss-os-on-your-system" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]780 Part 3 - Testing Bliss OS on your system
781 </a>
782
783 <nav class="md-nav">
784 <ul class="md-nav__list">
785
786 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]787 <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]788 Troubleshooting - Booting from the USB kicks me back to BIOS, or back to my Windows/macOS/Linux installation.
789 </a>
790
791</li>
792
793 </ul>
794 </nav>
795
796</li>
797
798 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]799 <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]800 Part 3 (alternate) - Using Bliss OS from your USB drive
801 </a>
802
803</li>
804
805 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]806 <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]807 Part 4 - Setting up and Installing Bliss OS on your HDD/SSD/SD card
808 </a>
809
810</li>
811
812 </ul>
813 </nav>
814
815</li>
816
817 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]818 <a href="#windows-based-installer-uefiesp-64-bit" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]819 Windows-based installer - UEFI/ESP (64-bit)
820 </a>
821
822 <nav class="md-nav">
823 <ul class="md-nav__list">
824
825 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]826 <a href="#part-1-using-the-installer" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]827 Part 1 - Using the Installer
828 </a>
829
830</li>
831
832 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]833 <a href="#part-2-switching-the-uefiefi-boot-entry" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]834 Part 2 - Switching the UEFI/EFI boot entry
835 </a>
836
837</li>
838
839 </ul>
840 </nav>
841
842</li>
843
844 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]845 <a href="#use-syslinux-efi-to-run-bliss-os-7x10x11x" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]846 Use syslinux EFI to run Bliss OS 7.x/10.x/11.x
847 </a>
848
849 <nav class="md-nav">
850 <ul class="md-nav__list">
851
852 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]853 <a href="#part-1-grab-the-required-tools" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]854 Part 1 - Grab the required tools
855 </a>
856
857</li>
858
859 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]860 <a href="#part-2-get-bliss-os" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]861 Part 2 - Get Bliss OS
862 </a>
863
864</li>
865
866 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]867 <a href="#part-3-get-the-syslinux-efi-bootstrap" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]868 Part 3 - Get the syslinux EFI bootstrap
869 </a>
870
871</li>
872
873 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]874 <a href="#part-4-version-specific" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]875 Part 4 - Version specific
876 </a>
877
878 <nav class="md-nav">
879 <ul class="md-nav__list">
880
881 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]882 <a href="#if-you-are-using-bliss-7x" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]883 If you are using Bliss 7.x
884 </a>
885
886</li>
887
888 </ul>
889 </nav>
890
891</li>
892
893 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]894 <a href="#if-you-are-using-bliss-10x" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]895 If you are using Bliss 10.x
896 </a>
897
898</li>
899
900 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]901 <a href="#part-5-creating-the-data-image" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]902 Part 5 - Creating the data image
903 </a>
904
905</li>
906
907 </ul>
908 </nav>
909
910</li>
911
912 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]913 <a href="#custom-install-bliss-os-8x10x11x-uefiesp-64-bit" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]914 Custom Install - Bliss OS 8.x/10.x/11.x UEFI/ESP (64-bit)
915 </a>
916
917 <nav class="md-nav">
918 <ul class="md-nav__list">
919
920 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]921 <a href="#part-1-mounting-your-uefiesp-partition" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]922 Part 1 - Mounting Your UEFI/ESP Partition
923 </a>
924
925 <nav class="md-nav">
926 <ul class="md-nav__list">
927
928 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]929 <a href="#cmd-is-not-showing-up-what-should-i-do" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]930 cmd is not showing up, what should I do?
931 </a>
932
933</li>
934
935 </ul>
936 </nav>
937
938</li>
939
940 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]941 <a href="#part-1-alternate-esp-setup" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]942 Part 1 (alternate) - ESP setup
943 </a>
944
945</li>
946
947 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]948 <a href="#part-1-alternate-killing-the-explorerexe" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]949 Part 1 (alternate) - Killing the explorer.exe
950 </a>
951
952</li>
953
954 </ul>
955 </nav>
956
957</li>
958
959 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]960 <a href="#part-2-uefi-installation" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]961 Part 2 - UEFI installation
962 </a>
963
964 <nav class="md-nav">
965 <ul class="md-nav__list">
966
967 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]968 <a href="#part-4-the-manual-blissification-of-your-pc" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]969 Part 4 - The Manual Blissification of Your PC
970 </a>
971
972</li>
973
974 </ul>
975 </nav>
976
977</li>
978
979 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]980 <a href="#install-bliss-os-on-a-vm-virtualbox" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]981 Install Bliss OS on a VM (virtualbox)
982 </a>
983
984</li>
985
986 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]987 <a href="#specific-surface-model-instructions" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]988 Specific Surface model instructions
989 </a>
990
991</li>
992
993 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]994 <a href="#conclusion" class="md-nav__link">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]995 Conclusion
996 </a>
997
998</li>
999
1000
1001
1002
1003
1004 </ul>
1005
1006</nav>
1007 </div>
1008 </div>
1009 </div>
1010
1011
1012 <div class="md-content">
1013 <article class="md-content__inner md-typeset">
1014
1015
1016
1017 <h1 id="installation-guide">Installation Guide</h1>
1018<h2 id="preface">Preface</h2>
1019<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>
1020<h2 id="warning">Warning!</h2>
1021<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>
1022<p>Any questions, install issues, bug reports, etc. <strong>MUST be</strong> accompanied with the following things:</p>
1023<ul>
1024<li>Log</li>
1025<li>Device info</li>
1026<li>Build info (file name)</li>
1027<li>Installation method (exact steps used)</li>
1028<li>Any other relevant information REQUIRED to diagnose your issue as NOT user error</li>
1029</ul>
1030<p>If the following information is not supplied, your inquiry will be <strong>ignored.</strong></p>
1031<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>
1032<h2 id="bootable-installation-method-mbruefiesp-3264-bit">Bootable installation method - MBR/UEFI/ESP (32/64-bit)</h2>
1033<p><strong>This is the current recommended method!</strong></p>
1034<p>Overview of the steps:</p>
1035<ul>
1036<li>Download the ISO file</li>
1037<li>Use Rufus or similar to burn to USB drive</li>
1038<li>Disable Secure Boot, Bitlocker, and any other boot security software such as Veracrypt</li>
1039<li>Boot into the USB drive.</li>
1040<li>Run Bliss OS in Live mode to test things out. If all is well, continue to next step</li>
1041<li>Boot into the USB drive, and choose Bliss OS Install</li>
1042</ul>
1043<p>Let's get started!</p>
1044<h3 id="part-1-gather-your-tools">Part 1 - Gather Your Tools</h3>
1045<p><strong>Please note that this method is not supported on all machines.</strong></p>
1046<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>
1047<p>You will need a decent speed USB drive (4 GB or larger is recommended).</p>
1048<h3 id="part-2-flashing-bliss-os-to-the-usb-drive">Part 2 - Flashing Bliss OS to the USB drive</h3>
1049<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>
1050<h3 id="part-3-testing-bliss-os-on-your-system">Part 3 - Testing Bliss OS on your system</h3>
1051<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]1052<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.
1053For 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]1054<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>
1055<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>
1056<h3 id="part-3-alternate-using-bliss-os-from-your-usb-drive">Part 3 (alternate) - Using Bliss OS from your USB drive</h3>
1057<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>
1058<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>
1059<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>
1060<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>
1061<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>
1062<p>Boot up the Bliss OS USB, and select the "Installation" option in <code>grub</code>. (It is the second one down, usually.)</p>
1063<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]1064<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]1065<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>
1066<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>
1067<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>
1068<p>Congratulations! We hope you enjoy using Bliss OS.</p>
1069<h2 id="windows-based-installer-uefiesp-64-bit">Windows-based installer - UEFI/ESP (64-bit)</h2>
1070<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>
1071<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>
1072<h3 id="part-1-using-the-installer">Part 1 - Using the Installer</h3>
1073<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>
Eric Park5ae1c6c2019-08-21 11:08:22 -0700[diff] [blame]1074<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>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]1075<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>
1076<h3 id="part-2-switching-the-uefiefi-boot-entry">Part 2 - Switching the UEFI/EFI boot entry</h3>
1077<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>
1078<h2 id="use-syslinux-efi-to-run-bliss-os-7x10x11x">Use syslinux EFI to run Bliss OS 7.x/10.x/11.x</h2>
1079<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>
1080<p>Use a Linux installation for the following procedure.</p>
1081<h3 id="part-1-grab-the-required-tools">Part 1 - Grab the required tools</h3>
1082<p>Install <code>unsquashfs</code> (part of <code>squashfs-tools</code>).</p>
1083<h3 id="part-2-get-bliss-os">Part 2 - Get Bliss OS</h3>
1084<p>Grab the latest build of Bliss OS 7.x/10.x/11.x.</p>
1085<h3 id="part-3-get-the-syslinux-efi-bootstrap">Part 3 - Get the syslinux EFI bootstrap</h3>
1086<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>
1087<p>Then, make a folder called <code>android</code>.</p>
1088<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>
1089<ul>
1090<li><code>initrd.img</code></li>
1091<li><code>ramdisk.img</code></li>
1092<li><code>kernel</code></li>
1093</ul>
1094<p>Extract <code>system.sfs</code> to a folder somewhere, such as <code>/tmp</code>.</p>
1095<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>
1096<p>Run the following:</p>
1097<p><code>unsquashfs ./system.sfs</code></p>
1098<p>This will make a new directory called <code>squashfs_root</code>.</p>
1099<h3 id="part-4-version-specific">Part 4 - Version specific</h3>
1100<h4 id="if-you-are-using-bliss-7x">If you are using Bliss 7.x</h4>
1101<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>
1102<h3 id="if-you-are-using-bliss-10x">If you are using Bliss 10.x</h3>
1103<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>
1104<p>Execute:</p>
1105<pre><code>mkdir /mnt/tempMount
1106truncate /tmp/system.img --size=2G
1107mkfs.ext4 -m0 /tmp/system.img
1108sudo mount -o loop /tmp/system.img /mnt/tempMount
1109sudo cp -prv /tmp/squashfs_root/* /mnt/tempMount/
1110sync
1111sudo umount /mnt/tempMount
1112</code></pre>
1113<p>The <code>sync</code> command might take some time.</p>
1114<p>Now copy the <code>/tmp/system.img</code> file to your USB's Android folder.</p>
1115<h3 id="part-5-creating-the-data-image">Part 5 - Creating the data image</h3>
1116<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>
1117<p><code>cd</code> into the <code>android</code> folder.</p>
1118<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>
1119<pre><code>truncate data.img --size=3G
1120mkfs.ext4 -m0 data.img
1121sync
1122</code></pre>
1123<p>This will be an completely empty <code>ext4</code> disk image, but will be enough to run Bliss.</p>
1124<p>Finally, check to ensure everything is in structured like so:</p>
1125<pre><code>&lt;ROOT&gt;
1126- syslinux.cfg
1127- android/
1128-- kernel
1129-- system.img
1130-- data.img
1131-- ramdisk.img
1132-- initrd.img
1133- EFI/
1134-- BOOT/
1135--- bootia32.efi
1136--- bootx64.efi
1137--- ldlinux.e32
1138--- ldlinux.e64
1139</code></pre>
1140<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>
1141<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>
1142<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>
1143<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>
1144<h3 id="part-1-mounting-your-uefiesp-partition">Part 1 - Mounting Your UEFI/ESP Partition</h3>
1145<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>
1146<h4 id="cmd-is-not-showing-up-what-should-i-do"><code>cmd</code> is not showing up, what should I do?</h4>
1147<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>
1148<p>Run the following:</p>
1149<pre><code>mountvol X: /S
1150</code></pre>
1151<p>Then check to see if it is mounted already. Run "Task Manager" by either</p>
1152<ul>
1153<li>Pressing Ctrl-Alt-Del and then clicking on "Task Manager", or</li>
1154<li>Pressing Ctrl-Shift-Esc</li>
1155</ul>
1156<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>
1157<ul>
1158<li>You have an ESP setup (follow the installation method below)</li>
1159<li>You have a legacy MBR setup</li>
1160<li>Your setup has a custom boot sequence</li>
1161</ul>
1162<h3 id="part-1-alternate-esp-setup">Part 1 (alternate) - ESP setup</h3>
1163<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>
1164<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>
1165<h3 id="part-1-alternate-killing-the-explorerexe">Part 1 (alternate) - Killing the <code>explorer.exe</code></h3>
1166<p>Run <code>cmd</code> as admin and enter the following command:</p>
1167<pre><code>taskkill /im explorer.exe /f
1168</code></pre>
1169<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>
1170<pre><code>mountvol X: /s
1171</code></pre>
1172<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>
1173<pre><code>explorer
1174</code></pre>
1175<p>This will run <code>explorer</code> as "Administrator" and will allow you to browse the mounted system partition.</p>
1176<p>The above may not work for all devices, as some handle UEFI differently.</p>
1177<h2 id="part-2-uefi-installation">Part 2 - UEFI installation</h2>
1178<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>
1179<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>
1180<p>If you are using Bliss OS 8.x/10.x, please use the <code>grub</code> entry below as a guide:</p>
1181<pre><code>menuentry 'Bliss-x86' --class android {
1182 search --file --no-floppy --set=root /AndroidOS/system.sfs
1183 linux /AndroidOS/kernel root=/dev/ram0 SRC=/AndroidOS androidboot.selinux=permissive androidboot.hardware=android_x86_64 quiet DATA=
1184 initrd /AndroidOS/initrd.img
1185}
1186</code></pre>
1187<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>
1188<pre><code>menuentry 'Bliss-x86' --class android {
1189 search --file --no-floppy --set=root /AndroidOS/system.sfs
1190 linux /AndroidOS/kernel root=/dev/ram0 SRC=/AndroidOS androidboot.selinux=permissive androidboot.hardware=android_x86_64 quiet DATA=
1191 initrd /AndroidOS/initrd.img
1192}
1193</code></pre>
1194<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>
1195<pre><code>mountvol X: /D
1196</code></pre>
1197<p>or if you used <code>Z:</code>, type:</p>
1198<pre><code>mountvol Z: /D
1199</code></pre>
1200<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>
1201<h3 id="part-4-the-manual-blissification-of-your-pc">Part 4 - The Manual Blissification of Your PC</h3>
1202<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>
1203<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>
1204<h2 id="install-bliss-os-on-a-vm-virtualbox">Install Bliss OS on a VM (virtualbox)</h2>
1205<p>This method does require some beefy PC specs, so it might not work for all. Thanks to Chih-Wei Huang from Android-x86 Project for the detailed information!</p>
1206<p>This method is currently being worked on. Check back later for more information!</p>
1207<p>Befor we proceed, if things don't work out, check <code>cat /proc/cpuinfo</code> to determine if your CPU is compatible with virtualization.</p>
1208<h2 id="specific-surface-model-instructions">Specific Surface model instructions</h2>
1209<p>Reference posts <a href="https://forum.xda-developers.com/showpost.php?p=78015375&amp;postcount=76">here</a> and <a href="https://forum.xda-developers.com/showpost.php?p=76896155&amp;postcount=2107">here</a>.</p>
1210<p>Many of you have a Surface device and would like to run Android on it. You're in luck, because this project was started with a Surface Pro 3 to test with back in Android Nougat. The device has since been retired and development has continued on a Surface Book, an IPTS device. This means it requires a specific set of firmware for proper functioning. For all other Surface models, the user must upgrade their own firmware, because it is too large of a burden to build for all Surface models without having those devices to test with.</p>
1211<p>To start, you will need to grab the right firmware for your device.</p>
1212<p>Surface Series Devices:</p>
1213<ul>
1214<li>Series 5 devices:</li>
1215<li>Surface Book 2</li>
1216<li>Surface Pro 2017</li>
1217<li>Series 4 devices</li>
1218<li>Surface Book</li>
1219<li>Surface Pro 4</li>
1220<li>Surface Laptop</li>
1221<li>Series 3 devices:</li>
1222<li>Surface Pro 3</li>
1223</ul>
1224<p>For the ipts_firmware files (series 4/5 devices only), please select the correct version for your device:</p>
1225<ul>
1226<li>v76 for the Surface Book</li>
1227<li>v78 for the Surface Pro 4</li>
1228<li>v79 for the Surface Laptop</li>
1229<li>v101 for Surface Book 2 15"</li>
1230<li>v102 for the Surface Pro 2017</li>
1231<li>v137 for the Surface Book 2 13"</li>
1232</ul>
1233<p>For the i915_firmware files (series 3/4/5 devices), please select the correct version for your device:</p>
1234<ul>
1235<li>kbl for series 5 devices</li>
1236<li>skl for series 4 devices</li>
1237<li>bxt for series 3 devices</li>
1238</ul>
1239<p>All <a href="https://github.com/jakeday/linux-surface/tree/master/firmware">firmware files can be found here.</a></p>
1240<p>For Surface Go users, you will have to remove some files and replace with @jakeday's firmware. Please <a href="https://www.reddit.com/r/SurfaceLinux/comments/9t53gq/wifi_fixed_on_surface_go_ubuntu_1810/">see this thread on Reddit</a> for detailed information.</p>
1241<p>Once you have the right firmware you need, you should copy it to a folder on your Bliss install (<code>SD_card_root/surface</code>), making sure to put the right firmware in the right folders:</p>
1242<ul>
1243<li>IPTS firmware: <code>SD_card_root/surface/intel/ipts</code></li>
1244<li>ath10k firmware (some models): <code>SD_card_root/surface/ath10k</code></li>
1245<li>mrvl firmware (some models): <code>SD_card_root/surface/mrvl</code></li>
1246<li>mwlwifi firmware (some models): <code>SD_card_root/surface/mwlwifi</code></li>
1247<li>nvidia firmware for SB2: <code>SD_card_root/surface/nvidia</code></li>
1248</ul>
1249<p>Next, open a terminal (we include one you can enable in "Developer Options"). In the terminal, enter the following commands, giving permission to the superuser popup dialog when prompted:</p>
1250<pre><code>su
1251mv -f SD_card_root/surface/* system/lib/firmware/
1252</code></pre>
1253<p>Then you can restart:</p>
1254<pre><code>reboot
1255</code></pre>
1256<p>It should recognize and load the correct firmware versions for your device upon reboot if you did everything correctly.</p>
1257<h2 id="conclusion">Conclusion</h2>
1258<p>Thanks for following along! If you want to check out the next guide, <a href="../extras/">click here!</a></p>
1259<p>Having problems with your new installation? <a href="../troubleshooting/">Check out Troubleshooting.</a></p>
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269 </article>
1270 </div>
1271 </div>
1272 </main>
1273
1274
1275<footer class="md-footer">
1276
1277 <div class="md-footer-nav">
1278 <nav class="md-footer-nav__inner md-grid">
1279
1280 <a href="../extras/" title="Extras" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev">
1281 <div class="md-flex__cell md-flex__cell--shrink">
1282 <i class="md-icon md-icon--arrow-back md-footer-nav__button"></i>
1283 </div>
1284 <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
1285 <span class="md-flex__ellipsis">
1286 <span class="md-footer-nav__direction">
1287 Previous
1288 </span>
1289 Extras
1290 </span>
1291 </div>
1292 </a>
1293
1294
1295 <a href="../troubleshooting/" title="Troubleshooting" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next">
1296 <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
1297 <span class="md-flex__ellipsis">
1298 <span class="md-footer-nav__direction">
1299 Next
1300 </span>
1301 Troubleshooting
1302 </span>
1303 </div>
1304 <div class="md-flex__cell md-flex__cell--shrink">
1305 <i class="md-icon md-icon--arrow-forward md-footer-nav__button"></i>
1306 </div>
1307 </a>
1308
1309 </nav>
1310 </div>
1311
1312 <div class="md-footer-meta md-typeset">
1313 <div class="md-footer-meta__inner md-grid">
1314 <div class="md-footer-copyright">
1315
1316 powered by
1317 <a href="https://www.mkdocs.org">MkDocs</a>
1318 and
1319 <a href="https://squidfunk.github.io/mkdocs-material/">
1320 Material for MkDocs</a>
1321 </div>
1322
1323 </div>
1324 </div>
1325</footer>
1326
1327 </div>
1328
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame^]1329 <script src="../../assets/javascripts/application.ac79c3b0.js"></script>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]1330
1331 <script>app.initialize({version:"1.0.4",url:{base:"../.."}})</script>
1332
1333
1334 </body>
1335</html>