Gitiles
Code Review Sign In
review.blissroms.org / Documentation-release / 8fd7bfbe8496c18e6ff09fdc4faac7330da89a61 / . / Bliss OS / installation-guide-misc / index.html
blob: 57f4df2516634da8d56f4036892b13e47c2a5ac2 [file] [log] [blame]
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]1
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]2<!doctype html>
3<html lang="en" class="no-js">
4 <head>
5
6 <meta charset="utf-8">
7 <meta name="viewport" content="width=device-width,initial-scale=1">
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]8
9
10
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]11 <link rel="shortcut icon" href="../../assets/images/favicon.png">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]12 <meta name="generator" content="mkdocs-1.1.2, mkdocs-material-6.0.1">
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]13
14
15
16 <title>Installation Guide (Misc) - Team Bliss</title>
17
18
19
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]20 <link rel="stylesheet" href="../../assets/stylesheets/main.38780c08.min.css">
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]21
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]22
23 <link rel="stylesheet" href="../../assets/stylesheets/palette.3f72e892.min.css">
24
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]25
26
27
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]28
29
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]30
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]31 <link href="https://fonts.gstatic.com" rel="preconnect" crossorigin>
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]32 <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,400,400i,700%7CRoboto+Mono&display=fallback">
33 <style>body,input{font-family:"Roboto",-apple-system,BlinkMacSystemFont,Helvetica,Arial,sans-serif}code,kbd,pre{font-family:"Roboto Mono",SFMono-Regular,Consolas,Menlo,monospace}</style>
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]34
35
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]36
37
38
39
40
41
42 </head>
43
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]44
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]45
46
47
48
49
50 <body dir="ltr" data-md-color-scheme="" data-md-color-primary="none" data-md-color-accent="none">
51
52
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]53 <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
54 <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]55 <label class="md-overlay" for="__drawer"></label>
56 <div data-md-component="skip">
57
58
59 <a href="#installation-guide-misc" class="md-skip">
60 Skip to content
61 </a>
62
63 </div>
64 <div data-md-component="announce">
65
66 </div>
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]67
68 <header class="md-header" data-md-component="header">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]69 <nav class="md-header-nav md-grid" aria-label="Header">
70 <a href="../.." title="Team Bliss" class="md-header-nav__button md-logo" aria-label="Team Bliss">
71
72
73 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 003-3 3 3 0 00-3-3 3 3 0 00-3 3 3 3 0 003 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54z"/></svg>
74
75 </a>
76 <label class="md-header-nav__button md-icon" for="__drawer">
77 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2z"/></svg>
78 </label>
79 <div class="md-header-nav__title" data-md-component="header-title">
80
81 <div class="md-header-nav__ellipsis">
82 <span class="md-header-nav__topic md-ellipsis">
83 Team Bliss
84 </span>
85 <span class="md-header-nav__topic md-ellipsis">
86
87 Installation Guide (Misc)
88
89 </span>
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]90 </div>
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]91
92 </div>
93
94 <label class="md-header-nav__button md-icon" for="__search">
95 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0116 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 019.5 16 6.5 6.5 0 013 9.5 6.5 6.5 0 019.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5z"/></svg>
96 </label>
97
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]98<div class="md-search" data-md-component="search" role="dialog">
99 <label class="md-search__overlay" for="__search"></label>
100 <div class="md-search__inner" role="search">
101 <form class="md-search__form" name="search">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]102 <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" data-md-state="active">
103 <label class="md-search__icon md-icon" for="__search">
104 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0116 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 019.5 16 6.5 6.5 0 013 9.5 6.5 6.5 0 019.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5z"/></svg>
105 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12z"/></svg>
106 </label>
107 <button type="reset" class="md-search__icon md-icon" aria-label="Clear" data-md-component="search-reset" tabindex="-1">
108 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41L17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41z"/></svg>
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]109 </button>
110 </form>
111 <div class="md-search__output">
112 <div class="md-search__scrollwrap" data-md-scrollfix>
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]113 <div class="md-search-result" data-md-component="search-result">
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]114 <div class="md-search-result__meta">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]115 Initializing search
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]116 </div>
117 <ol class="md-search-result__list"></ol>
118 </div>
119 </div>
120 </div>
121 </div>
122</div>
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]123
124
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]125 </nav>
126</header>
127
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]128 <div class="md-container" data-md-component="container">
129
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]130
131
132
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]133 <main class="md-main" data-md-component="main">
134 <div class="md-main__inner md-grid">
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]135
136
137 <div class="md-sidebar md-sidebar--primary" data-md-component="navigation">
138 <div class="md-sidebar__scrollwrap">
139 <div class="md-sidebar__inner">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]140 <nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
141 <label class="md-nav__title" for="__drawer">
142 <a href="../.." title="Team Bliss" class="md-nav__button md-logo" aria-label="Team Bliss">
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]143
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]144
145 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 003-3 3 3 0 00-3-3 3 3 0 00-3 3 3 3 0 003 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54z"/></svg>
146
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]147 </a>
148 Team Bliss
149 </label>
150
151 <ul class="md-nav__list" data-md-scrollfix>
152
153
154
155
156
157
158 <li class="md-nav__item">
159 <a href="../.." title="Home" class="md-nav__link">
160 Home
161 </a>
162 </li>
163
164
165
166
167
168
169
170
171
172 <li class="md-nav__item md-nav__item--active md-nav__item--nested">
173
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]174 <input class="md-nav__toggle md-toggle" data-md-toggle="nav-2" type="checkbox" id="nav-2" checked>
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]175
176 <label class="md-nav__link" for="nav-2">
177 Bliss OS
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]178 <span class="md-nav__icon md-icon"></span>
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]179 </label>
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]180 <nav class="md-nav" aria-label="Bliss OS" data-md-level="1">
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]181 <label class="md-nav__title" for="nav-2">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]182 <span class="md-nav__icon md-icon"></span>
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]183 Bliss OS
184 </label>
185 <ul class="md-nav__list" data-md-scrollfix>
186
187
188
189
190
191
192
193 <li class="md-nav__item">
194 <a href="../" title="Index" class="md-nav__link">
195 Index
196 </a>
197 </li>
198
199
200
201
202
203
204
205 <li class="md-nav__item">
206 <a href="../build-guide/" title="Build Guide" class="md-nav__link">
207 Build Guide
208 </a>
209 </li>
210
211
212
213
214
215
216
217 <li class="md-nav__item">
218 <a href="../extras/" title="Extras" class="md-nav__link">
219 Extras
220 </a>
221 </li>
222
223
224
225
226
227
228
229
230
231 <li class="md-nav__item md-nav__item--active">
232
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]233 <input class="md-nav__toggle md-toggle" data-md-toggle="toc" type="checkbox" id="__toc">
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]234
235
236
237
238 <label class="md-nav__link md-nav__link--active" for="__toc">
239 Installation Guide (Misc)
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]240 <span class="md-nav__icon md-icon"></span>
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]241 </label>
242
243 <a href="./" title="Installation Guide (Misc)" class="md-nav__link md-nav__link--active">
244 Installation Guide (Misc)
245 </a>
246
247
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]248<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]249
250
251
252
253
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]254 <label class="md-nav__title" for="__toc">
255 <span class="md-nav__icon md-icon"></span>
256 Table of contents
257 </label>
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]258 <ul class="md-nav__list" data-md-scrollfix>
259
260 <li class="md-nav__item">
261 <a href="#windows-based-installer-uefiesp-64-bit" class="md-nav__link">
262 Windows-based installer - UEFI/ESP (64-bit)
263 </a>
264
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]265 <nav class="md-nav" aria-label="Windows-based installer - UEFI/ESP (64-bit)">
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]266 <ul class="md-nav__list">
267
268 <li class="md-nav__item">
269 <a href="#part-1-using-the-installer" class="md-nav__link">
270 Part 1 - Using the Installer
271 </a>
272
273</li>
274
275 <li class="md-nav__item">
276 <a href="#part-2-switching-the-uefiefi-boot-entry" class="md-nav__link">
277 Part 2 - Switching the UEFI/EFI boot entry
278 </a>
279
280</li>
281
282 </ul>
283 </nav>
284
285</li>
286
287 <li class="md-nav__item">
288 <a href="#use-syslinux-efi-to-run-bliss-os-7x10x11x" class="md-nav__link">
289 Use syslinux EFI to run Bliss OS 7.x/10.x/11.x
290 </a>
291
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]292 <nav class="md-nav" aria-label="Use syslinux EFI to run Bliss OS 7.x/10.x/11.x">
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]293 <ul class="md-nav__list">
294
295 <li class="md-nav__item">
296 <a href="#part-1-grab-the-required-tools" class="md-nav__link">
297 Part 1 - Grab the required tools
298 </a>
299
300</li>
301
302 <li class="md-nav__item">
303 <a href="#part-2-get-bliss-os" class="md-nav__link">
304 Part 2 - Get Bliss OS
305 </a>
306
307</li>
308
309 <li class="md-nav__item">
310 <a href="#part-3-get-the-syslinux-efi-bootstrap" class="md-nav__link">
311 Part 3 - Get the syslinux EFI bootstrap
312 </a>
313
314</li>
315
316 <li class="md-nav__item">
317 <a href="#part-4-version-specific" class="md-nav__link">
318 Part 4 - Version specific
319 </a>
320
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]321 <nav class="md-nav" aria-label="Part 4 - Version specific">
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]322 <ul class="md-nav__list">
323
324 <li class="md-nav__item">
325 <a href="#if-you-are-using-bliss-7x" class="md-nav__link">
326 If you are using Bliss 7.x
327 </a>
328
329</li>
330
331 </ul>
332 </nav>
333
334</li>
335
336 <li class="md-nav__item">
337 <a href="#if-you-are-using-bliss-10x" class="md-nav__link">
338 If you are using Bliss 10.x
339 </a>
340
341</li>
342
343 <li class="md-nav__item">
344 <a href="#part-5-creating-the-data-image" class="md-nav__link">
345 Part 5 - Creating the data image
346 </a>
347
348</li>
349
350 </ul>
351 </nav>
352
353</li>
354
355 <li class="md-nav__item">
356 <a href="#custom-install-bliss-os-8x10x11x-uefiesp-64-bit" class="md-nav__link">
357 Custom Install - Bliss OS 8.x/10.x/11.x UEFI/ESP (64-bit)
358 </a>
359
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]360 <nav class="md-nav" aria-label="Custom Install - Bliss OS 8.x/10.x/11.x UEFI/ESP (64-bit)">
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]361 <ul class="md-nav__list">
362
363 <li class="md-nav__item">
364 <a href="#part-1-mounting-your-uefiesp-partition" class="md-nav__link">
365 Part 1 - Mounting Your UEFI/ESP Partition
366 </a>
367
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]368 <nav class="md-nav" aria-label="Part 1 - Mounting Your UEFI/ESP Partition">
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]369 <ul class="md-nav__list">
370
371 <li class="md-nav__item">
372 <a href="#cmd-is-not-showing-up-what-should-i-do" class="md-nav__link">
373 cmd is not showing up, what should I do?
374 </a>
375
376</li>
377
378 </ul>
379 </nav>
380
381</li>
382
383 <li class="md-nav__item">
384 <a href="#part-1-alternate-esp-setup" class="md-nav__link">
385 Part 1 (alternate) - ESP setup
386 </a>
387
388</li>
389
390 <li class="md-nav__item">
391 <a href="#part-1-alternate-killing-the-explorerexe" class="md-nav__link">
392 Part 1 (alternate) - Killing the explorer.exe
393 </a>
394
395</li>
396
397 </ul>
398 </nav>
399
400</li>
401
402 <li class="md-nav__item">
403 <a href="#part-2-uefi-installation" class="md-nav__link">
404 Part 2 - UEFI installation
405 </a>
406
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]407 <nav class="md-nav" aria-label="Part 2 - UEFI installation">
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]408 <ul class="md-nav__list">
409
410 <li class="md-nav__item">
411 <a href="#part-4-the-manual-blissification-of-your-pc" class="md-nav__link">
412 Part 4 - The Manual Blissification of Your PC
413 </a>
414
415</li>
416
417 </ul>
418 </nav>
419
420</li>
421
422 <li class="md-nav__item">
423 <a href="#install-bliss-os-on-a-vm-virtualbox" class="md-nav__link">
424 Install Bliss OS on a VM (virtualbox)
425 </a>
426
427</li>
428
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]429 </ul>
430
431</nav>
432
433 </li>
434
435
436
437
438
439
440
441 <li class="md-nav__item">
442 <a href="../installation-guide-surface-devices/" title="Installation Guide (Surface devices)" class="md-nav__link">
443 Installation Guide (Surface devices)
444 </a>
445 </li>
446
447
448
449
450
451
452
453 <li class="md-nav__item">
454 <a href="../installation-guide/" title="Installation Guide" class="md-nav__link">
455 Installation Guide
456 </a>
457 </li>
458
459
460
461
462
463
464
465 <li class="md-nav__item">
Eric Park0509f652020-03-01 01:54:39 +0900[diff] [blame]466 <a href="../taking-bug-reports/" title="Taking bug reports" class="md-nav__link">
467 Taking bug reports
468 </a>
469 </li>
470
471
472
473
474
475
476
477 <li class="md-nav__item">
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]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
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]496 <input class="md-nav__toggle md-toggle" data-md-toggle="nav-3" type="checkbox" id="nav-3">
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]497
498 <label class="md-nav__link" for="nav-3">
499 BlissRoms
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]500 <span class="md-nav__icon md-icon"></span>
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]501 </label>
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]502 <nav class="md-nav" aria-label="BlissRoms" data-md-level="1">
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]503 <label class="md-nav__title" for="nav-3">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]504 <span class="md-nav__icon md-icon"></span>
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]505 BlissRoms
506 </label>
507 <ul class="md-nav__list" data-md-scrollfix>
508
509
510
511
512
513
514
515 <li class="md-nav__item">
516 <a href="../../BlissRoms/" title="Index" class="md-nav__link">
517 Index
518 </a>
519 </li>
520
521
522
523
524
525
526
527 <li class="md-nav__item">
528 <a href="../../BlissRoms/build-guide/" title="Build Guide" class="md-nav__link">
529 Build Guide
530 </a>
531 </li>
532
533
534
535
536
537
538
539 <li class="md-nav__item">
540 <a href="../../BlissRoms/build-tips/" title="Build Tips" class="md-nav__link">
541 Build Tips
542 </a>
543 </li>
544
545
546 </ul>
547 </nav>
548 </li>
549
550
551
552
553
554
555
556 <li class="md-nav__item md-nav__item--nested">
557
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]558 <input class="md-nav__toggle md-toggle" data-md-toggle="nav-4" type="checkbox" id="nav-4">
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]559
560 <label class="md-nav__link" for="nav-4">
561 Common
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]562 <span class="md-nav__icon md-icon"></span>
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]563 </label>
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]564 <nav class="md-nav" aria-label="Common" data-md-level="1">
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]565 <label class="md-nav__title" for="nav-4">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]566 <span class="md-nav__icon md-icon"></span>
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]567 Common
568 </label>
569 <ul class="md-nav__list" data-md-scrollfix>
570
571
572
573
574
575
576
577 <li class="md-nav__item">
578 <a href="../../common/" title="Index" class="md-nav__link">
579 Index
580 </a>
581 </li>
582
583
584
585
586
587
588
589 <li class="md-nav__item">
590 <a href="../../common/git-started/" title="Git Started" class="md-nav__link">
591 Git Started
592 </a>
593 </li>
594
595
596
597
598
599
600
601 <li class="md-nav__item">
602 <a href="../../common/maintaining-proper-authorship/" title="Maintaining proper authorship" class="md-nav__link">
603 Maintaining proper authorship
604 </a>
605 </li>
606
607
608
609
610
611
612
613 <li class="md-nav__item">
614 <a href="../../common/using-dippy-bird/" title="Using `dippy-bird`" class="md-nav__link">
615 Using `dippy-bird`
616 </a>
617 </li>
618
619
620 </ul>
621 </nav>
622 </li>
623
624
625
626
627
628
629
630 <li class="md-nav__item md-nav__item--nested">
631
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]632 <input class="md-nav__toggle md-toggle" data-md-toggle="nav-5" type="checkbox" id="nav-5">
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]633
634 <label class="md-nav__link" for="nav-5">
635 Infrastructure
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]636 <span class="md-nav__icon md-icon"></span>
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]637 </label>
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]638 <nav class="md-nav" aria-label="Infrastructure" data-md-level="1">
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]639 <label class="md-nav__title" for="nav-5">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]640 <span class="md-nav__icon md-icon"></span>
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]641 Infrastructure
642 </label>
643 <ul class="md-nav__list" data-md-scrollfix>
644
645
646
647
648
649
650
651 <li class="md-nav__item">
652 <a href="../../infrastructure/" title="Index" class="md-nav__link">
653 Index
654 </a>
655 </li>
656
657
658 </ul>
659 </nav>
660 </li>
661
662
663 </ul>
664</nav>
665 </div>
666 </div>
667 </div>
668
669
670 <div class="md-sidebar md-sidebar--secondary" data-md-component="toc">
671 <div class="md-sidebar__scrollwrap">
672 <div class="md-sidebar__inner">
673
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]674<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]675
676
677
678
679
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]680 <label class="md-nav__title" for="__toc">
681 <span class="md-nav__icon md-icon"></span>
682 Table of contents
683 </label>
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]684 <ul class="md-nav__list" data-md-scrollfix>
685
686 <li class="md-nav__item">
687 <a href="#windows-based-installer-uefiesp-64-bit" class="md-nav__link">
688 Windows-based installer - UEFI/ESP (64-bit)
689 </a>
690
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]691 <nav class="md-nav" aria-label="Windows-based installer - UEFI/ESP (64-bit)">
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]692 <ul class="md-nav__list">
693
694 <li class="md-nav__item">
695 <a href="#part-1-using-the-installer" class="md-nav__link">
696 Part 1 - Using the Installer
697 </a>
698
699</li>
700
701 <li class="md-nav__item">
702 <a href="#part-2-switching-the-uefiefi-boot-entry" class="md-nav__link">
703 Part 2 - Switching the UEFI/EFI boot entry
704 </a>
705
706</li>
707
708 </ul>
709 </nav>
710
711</li>
712
713 <li class="md-nav__item">
714 <a href="#use-syslinux-efi-to-run-bliss-os-7x10x11x" class="md-nav__link">
715 Use syslinux EFI to run Bliss OS 7.x/10.x/11.x
716 </a>
717
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]718 <nav class="md-nav" aria-label="Use syslinux EFI to run Bliss OS 7.x/10.x/11.x">
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]719 <ul class="md-nav__list">
720
721 <li class="md-nav__item">
722 <a href="#part-1-grab-the-required-tools" class="md-nav__link">
723 Part 1 - Grab the required tools
724 </a>
725
726</li>
727
728 <li class="md-nav__item">
729 <a href="#part-2-get-bliss-os" class="md-nav__link">
730 Part 2 - Get Bliss OS
731 </a>
732
733</li>
734
735 <li class="md-nav__item">
736 <a href="#part-3-get-the-syslinux-efi-bootstrap" class="md-nav__link">
737 Part 3 - Get the syslinux EFI bootstrap
738 </a>
739
740</li>
741
742 <li class="md-nav__item">
743 <a href="#part-4-version-specific" class="md-nav__link">
744 Part 4 - Version specific
745 </a>
746
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]747 <nav class="md-nav" aria-label="Part 4 - Version specific">
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]748 <ul class="md-nav__list">
749
750 <li class="md-nav__item">
751 <a href="#if-you-are-using-bliss-7x" class="md-nav__link">
752 If you are using Bliss 7.x
753 </a>
754
755</li>
756
757 </ul>
758 </nav>
759
760</li>
761
762 <li class="md-nav__item">
763 <a href="#if-you-are-using-bliss-10x" class="md-nav__link">
764 If you are using Bliss 10.x
765 </a>
766
767</li>
768
769 <li class="md-nav__item">
770 <a href="#part-5-creating-the-data-image" class="md-nav__link">
771 Part 5 - Creating the data image
772 </a>
773
774</li>
775
776 </ul>
777 </nav>
778
779</li>
780
781 <li class="md-nav__item">
782 <a href="#custom-install-bliss-os-8x10x11x-uefiesp-64-bit" class="md-nav__link">
783 Custom Install - Bliss OS 8.x/10.x/11.x UEFI/ESP (64-bit)
784 </a>
785
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]786 <nav class="md-nav" aria-label="Custom Install - Bliss OS 8.x/10.x/11.x UEFI/ESP (64-bit)">
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]787 <ul class="md-nav__list">
788
789 <li class="md-nav__item">
790 <a href="#part-1-mounting-your-uefiesp-partition" class="md-nav__link">
791 Part 1 - Mounting Your UEFI/ESP Partition
792 </a>
793
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]794 <nav class="md-nav" aria-label="Part 1 - Mounting Your UEFI/ESP Partition">
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]795 <ul class="md-nav__list">
796
797 <li class="md-nav__item">
798 <a href="#cmd-is-not-showing-up-what-should-i-do" class="md-nav__link">
799 cmd is not showing up, what should I do?
800 </a>
801
802</li>
803
804 </ul>
805 </nav>
806
807</li>
808
809 <li class="md-nav__item">
810 <a href="#part-1-alternate-esp-setup" class="md-nav__link">
811 Part 1 (alternate) - ESP setup
812 </a>
813
814</li>
815
816 <li class="md-nav__item">
817 <a href="#part-1-alternate-killing-the-explorerexe" class="md-nav__link">
818 Part 1 (alternate) - Killing the explorer.exe
819 </a>
820
821</li>
822
823 </ul>
824 </nav>
825
826</li>
827
828 <li class="md-nav__item">
829 <a href="#part-2-uefi-installation" class="md-nav__link">
830 Part 2 - UEFI installation
831 </a>
832
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]833 <nav class="md-nav" aria-label="Part 2 - UEFI installation">
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]834 <ul class="md-nav__list">
835
836 <li class="md-nav__item">
837 <a href="#part-4-the-manual-blissification-of-your-pc" class="md-nav__link">
838 Part 4 - The Manual Blissification of Your PC
839 </a>
840
841</li>
842
843 </ul>
844 </nav>
845
846</li>
847
848 <li class="md-nav__item">
849 <a href="#install-bliss-os-on-a-vm-virtualbox" class="md-nav__link">
850 Install Bliss OS on a VM (virtualbox)
851 </a>
852
853</li>
854
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]855 </ul>
856
857</nav>
858 </div>
859 </div>
860 </div>
861
862
863 <div class="md-content">
864 <article class="md-content__inner md-typeset">
865
866
867
868 <h1 id="installation-guide-misc">Installation Guide (Misc)</h1>
869<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>
870<h2 id="windows-based-installer-uefiesp-64-bit">Windows-based installer - UEFI/ESP (64-bit)</h2>
871<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>
872<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>
873<h3 id="part-1-using-the-installer">Part 1 - Using the Installer</h3>
874<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>
875<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>
876<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>
877<h3 id="part-2-switching-the-uefiefi-boot-entry">Part 2 - Switching the UEFI/EFI boot entry</h3>
878<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>
879<h2 id="use-syslinux-efi-to-run-bliss-os-7x10x11x">Use syslinux EFI to run Bliss OS 7.x/10.x/11.x</h2>
880<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>
881<p>Use a Linux installation for the following procedure.</p>
882<h3 id="part-1-grab-the-required-tools">Part 1 - Grab the required tools</h3>
883<p>Install <code>unsquashfs</code> (part of <code>squashfs-tools</code>).</p>
884<h3 id="part-2-get-bliss-os">Part 2 - Get Bliss OS</h3>
885<p>Grab the latest build of Bliss OS 7.x/10.x/11.x.</p>
886<h3 id="part-3-get-the-syslinux-efi-bootstrap">Part 3 - Get the syslinux EFI bootstrap</h3>
887<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>
888<p>Then, make a folder called <code>android</code>.</p>
889<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>
890<ul>
891<li><code>initrd.img</code></li>
892<li><code>ramdisk.img</code></li>
893<li><code>kernel</code></li>
894</ul>
895<p>Extract <code>system.sfs</code> to a folder somewhere, such as <code>/tmp</code>.</p>
896<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>
897<p>Run the following:</p>
898<p><code>unsquashfs ./system.sfs</code></p>
899<p>This will make a new directory called <code>squashfs_root</code>.</p>
900<h3 id="part-4-version-specific">Part 4 - Version specific</h3>
901<h4 id="if-you-are-using-bliss-7x">If you are using Bliss 7.x</h4>
902<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>
903<h3 id="if-you-are-using-bliss-10x">If you are using Bliss 10.x</h3>
904<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>
905<p>Execute:</p>
906<pre><code>mkdir /mnt/tempMount
907truncate /tmp/system.img --size=2G
908mkfs.ext4 -m0 /tmp/system.img
909sudo mount -o loop /tmp/system.img /mnt/tempMount
910sudo cp -prv /tmp/squashfs_root/* /mnt/tempMount/
911sync
912sudo umount /mnt/tempMount
913</code></pre>
914<p>The <code>sync</code> command might take some time.</p>
915<p>Now copy the <code>/tmp/system.img</code> file to your USB's Android folder.</p>
916<h3 id="part-5-creating-the-data-image">Part 5 - Creating the data image</h3>
917<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>
918<p><code>cd</code> into the <code>android</code> folder.</p>
919<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>
920<pre><code>truncate data.img --size=3G
921mkfs.ext4 -m0 data.img
922sync
923</code></pre>
924<p>This will be an completely empty <code>ext4</code> disk image, but will be enough to run Bliss.</p>
925<p>Finally, check to ensure everything is in structured like so:</p>
926<pre><code>&lt;ROOT&gt;
927- syslinux.cfg
928- android/
929-- kernel
930-- system.img
931-- data.img
932-- ramdisk.img
933-- initrd.img
934- EFI/
935-- BOOT/
936--- bootia32.efi
937--- bootx64.efi
938--- ldlinux.e32
939--- ldlinux.e64
940</code></pre>
941<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>
942<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>
943<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>
944<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>
945<h3 id="part-1-mounting-your-uefiesp-partition">Part 1 - Mounting Your UEFI/ESP Partition</h3>
946<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>
947<h4 id="cmd-is-not-showing-up-what-should-i-do"><code>cmd</code> is not showing up, what should I do?</h4>
948<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>
949<p>Run the following:</p>
950<pre><code>mountvol X: /S
951</code></pre>
952<p>Then check to see if it is mounted already. Run "Task Manager" by either</p>
953<ul>
954<li>Pressing Ctrl-Alt-Del and then clicking on "Task Manager", or</li>
955<li>Pressing Ctrl-Shift-Esc</li>
956</ul>
957<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>
958<ul>
959<li>You have an ESP setup (follow the installation method below)</li>
960<li>You have a legacy MBR setup</li>
961<li>Your setup has a custom boot sequence</li>
962</ul>
963<h3 id="part-1-alternate-esp-setup">Part 1 (alternate) - ESP setup</h3>
964<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>
965<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>
966<h3 id="part-1-alternate-killing-the-explorerexe">Part 1 (alternate) - Killing the <code>explorer.exe</code></h3>
967<p>Run <code>cmd</code> as admin and enter the following command:</p>
968<pre><code>taskkill /im explorer.exe /f
969</code></pre>
970<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>
971<pre><code>mountvol X: /s
972</code></pre>
973<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>
974<pre><code>explorer
975</code></pre>
976<p>This will run <code>explorer</code> as "Administrator" and will allow you to browse the mounted system partition.</p>
977<p>The above may not work for all devices, as some handle UEFI differently.</p>
978<h2 id="part-2-uefi-installation">Part 2 - UEFI installation</h2>
979<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>
980<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>
981<p>If you are using Bliss OS 8.x/10.x, please use the <code>grub</code> entry below as a guide:</p>
982<pre><code>menuentry 'Bliss-x86' --class android {
983 search --file --no-floppy --set=root /AndroidOS/system.sfs
984 linux /AndroidOS/kernel root=/dev/ram0 SRC=/AndroidOS androidboot.selinux=permissive androidboot.hardware=android_x86_64 quiet DATA=
985 initrd /AndroidOS/initrd.img
986}
987</code></pre>
988<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>
989<pre><code>menuentry 'Bliss-x86' --class android {
990 search --file --no-floppy --set=root /AndroidOS/system.sfs
991 linux /AndroidOS/kernel root=/dev/ram0 SRC=/AndroidOS androidboot.selinux=permissive androidboot.hardware=android_x86_64 quiet DATA=
992 initrd /AndroidOS/initrd.img
993}
994</code></pre>
995<p>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>
996<pre><code>mountvol X: /D
997</code></pre>
998<p>or if you used <code>Z:</code>, type:</p>
999<pre><code>mountvol Z: /D
1000</code></pre>
1001<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>
1002<h3 id="part-4-the-manual-blissification-of-your-pc">Part 4 - The Manual Blissification of Your PC</h3>
1003<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>
1004<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>
1005<h2 id="install-bliss-os-on-a-vm-virtualbox">Install Bliss OS on a VM (virtualbox)</h2>
1006<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>
1007<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>
1008<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>
1009<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>
1010<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>
1011<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>
1012<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>
1013<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>
1014<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>
1015
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]1016
1017
1018
1019
1020
1021
1022 </article>
1023 </div>
1024 </div>
1025 </main>
1026
1027
1028<footer class="md-footer">
1029
1030 <div class="md-footer-nav">
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]1031 <nav class="md-footer-nav__inner md-grid" aria-label="Footer">
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]1032
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]1033 <a href="../extras/" title="Extras" class="md-footer-nav__link md-footer-nav__link--prev" rel="prev">
1034 <div class="md-footer-nav__button md-icon">
1035 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12z"/></svg>
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]1036 </div>
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]1037 <div class="md-footer-nav__title">
1038 <div class="md-ellipsis">
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]1039 <span class="md-footer-nav__direction">
1040 Previous
1041 </span>
1042 Extras
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]1043 </div>
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]1044 </div>
1045 </a>
1046
1047
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]1048 <a href="../installation-guide-surface-devices/" title="Installation Guide (Surface devices)" class="md-footer-nav__link md-footer-nav__link--next" rel="next">
1049 <div class="md-footer-nav__title">
1050 <div class="md-ellipsis">
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]1051 <span class="md-footer-nav__direction">
1052 Next
1053 </span>
1054 Installation Guide (Surface devices)
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]1055 </div>
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]1056 </div>
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]1057 <div class="md-footer-nav__button md-icon">
1058 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M4 11v2h12l-5.5 5.5 1.42 1.42L19.84 12l-7.92-7.92L10.5 5.5 16 11H4z"/></svg>
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]1059 </div>
1060 </a>
1061
1062 </nav>
1063 </div>
1064
1065 <div class="md-footer-meta md-typeset">
1066 <div class="md-footer-meta__inner md-grid">
1067 <div class="md-footer-copyright">
1068
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]1069 Made with
1070 <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
1071 Material for MkDocs
1072 </a>
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]1073 </div>
1074
1075 </div>
1076 </div>
1077</footer>
1078
1079 </div>
1080
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]1081 <script src="../../assets/javascripts/vendor.77e55a48.min.js"></script>
1082 <script src="../../assets/javascripts/bundle.aa3f9871.min.js"></script><script id="__lang" type="application/json">{"clipboard.copy": "Copy to clipboard", "clipboard.copied": "Copied to clipboard", "search.config.lang": "en", "search.config.pipeline": "trimmer, stopWordFilter", "search.config.separator": "[\\s\\-]+", "search.result.placeholder": "Type to start searching", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.term.missing": "Missing"}</script>
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]1083
Eric Park8fd7bfb2020-10-02 19:05:33 +0900[diff] [blame^]1084 <script>
1085 app = initialize({
1086 base: "../..",
1087 features: [],
1088 search: Object.assign({
1089 worker: "../../assets/javascripts/worker/search.4ac00218.min.js"
1090 }, typeof search !== "undefined" && search)
1091 })
1092 </script>
Eric Parkd09b00e2020-02-15 11:07:48 +0900[diff] [blame]1093
1094
1095 </body>
1096</html>