User documentation and guides for products sold on the Libre Tech Shop. https://docs.libretech.shop
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

1093 lines
30 KiB

  1. <!doctype html>
  2. <html lang="en" class="no-js">
  3. <head>
  4. <meta charset="utf-8">
  5. <meta name="viewport" content="width=device-width,initial-scale=1">
  6. <meta name="description" content="Accessible & Free Documentation for Libre Products">
  7. <meta name="author" content="Abhas Abhinav">
  8. <link rel="icon" href="../../images/als-icon.png">
  9. <meta name="generator" content="mkdocs-1.2.3, mkdocs-material-8.1.7">
  10. <title>(MHUSB) FAQs - LibreTechShop - Documentation</title>
  11. <link rel="stylesheet" href="../../assets/stylesheets/main.cd566b2a.min.css">
  12. <link rel="stylesheet" href="../../assets/stylesheets/palette.e6a45f82.min.css">
  13. <meta name="theme-color" content="#7e56c2">
  14. <link rel="stylesheet" href="../../css/extra.css">
  15. <script>__md_scope=new URL("../..",location),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
  16. </head>
  17. <body dir="ltr" data-md-color-scheme="light" data-md-color-primary="deep-purple" data-md-color-accent="pink">
  18. <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
  19. <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
  20. <label class="md-overlay" for="__drawer"></label>
  21. <div data-md-component="skip">
  22. <a href="#troubleshooting-faqs" class="md-skip">
  23. Skip to content
  24. </a>
  25. </div>
  26. <div data-md-component="announce">
  27. </div>
  28. <header class="md-header" data-md-component="header">
  29. <nav class="md-header__inner md-grid" aria-label="Header">
  30. <a href="../.." title="LibreTechShop - Documentation" class="md-header__button md-logo" aria-label="LibreTechShop - Documentation" data-md-component="logo">
  31. <img src="../../images/als-icon.png" alt="logo">
  32. </a>
  33. <label class="md-header__button md-icon" for="__drawer">
  34. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2z"/></svg>
  35. </label>
  36. <div class="md-header__title" data-md-component="header-title">
  37. <div class="md-header__ellipsis">
  38. <div class="md-header__topic">
  39. <span class="md-ellipsis">
  40. LibreTechShop - Documentation
  41. </span>
  42. </div>
  43. <div class="md-header__topic" data-md-component="header-topic">
  44. <span class="md-ellipsis">
  45. (MHUSB) FAQs
  46. </span>
  47. </div>
  48. </div>
  49. </div>
  50. <label class="md-header__button md-icon" for="__search">
  51. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 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 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5z"/></svg>
  52. </label>
  53. <div class="md-search" data-md-component="search" role="dialog">
  54. <label class="md-search__overlay" for="__search"></label>
  55. <div class="md-search__inner" role="search">
  56. <form class="md-search__form" name="search">
  57. <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" required>
  58. <label class="md-search__icon md-icon" for="__search">
  59. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 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 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5z"/></svg>
  60. <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>
  61. </label>
  62. <nav class="md-search__options" aria-label="Search">
  63. <button type="reset" class="md-search__icon md-icon" aria-label="Clear" tabindex="-1">
  64. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.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>
  65. </button>
  66. </nav>
  67. </form>
  68. <div class="md-search__output">
  69. <div class="md-search__scrollwrap" data-md-scrollfix>
  70. <div class="md-search-result" data-md-component="search-result">
  71. <div class="md-search-result__meta">
  72. Initializing search
  73. </div>
  74. <ol class="md-search-result__list"></ol>
  75. </div>
  76. </div>
  77. </div>
  78. </div>
  79. </div>
  80. <div class="md-header__source">
  81. <a href="https://sovran.dev/mh/lts-docs" title="Go to repository" class="md-source" data-md-component="source">
  82. <div class="md-source__icon md-icon">
  83. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
  84. </div>
  85. <div class="md-source__repository">
  86. mh/lts-docs
  87. </div>
  88. </a>
  89. </div>
  90. </nav>
  91. </header>
  92. <div class="md-container" data-md-component="container">
  93. <main class="md-main" data-md-component="main">
  94. <div class="md-main__inner md-grid">
  95. <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
  96. <div class="md-sidebar__scrollwrap">
  97. <div class="md-sidebar__inner">
  98. <nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
  99. <label class="md-nav__title" for="__drawer">
  100. <a href="../.." title="LibreTechShop - Documentation" class="md-nav__button md-logo" aria-label="LibreTechShop - Documentation" data-md-component="logo">
  101. <img src="../../images/als-icon.png" alt="logo">
  102. </a>
  103. LibreTechShop - Documentation
  104. </label>
  105. <div class="md-nav__source">
  106. <a href="https://sovran.dev/mh/lts-docs" title="Go to repository" class="md-source" data-md-component="source">
  107. <div class="md-source__icon md-icon">
  108. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
  109. </div>
  110. <div class="md-source__repository">
  111. mh/lts-docs
  112. </div>
  113. </a>
  114. </div>
  115. <ul class="md-nav__list" data-md-scrollfix>
  116. <li class="md-nav__item">
  117. <a href="../.." class="md-nav__link">
  118. Home
  119. </a>
  120. </li>
  121. <li class="md-nav__item md-nav__item--nested">
  122. <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_2" type="checkbox" id="__nav_2" >
  123. <label class="md-nav__link" for="__nav_2">
  124. LC230
  125. <span class="md-nav__icon md-icon"></span>
  126. </label>
  127. <nav class="md-nav" aria-label="LC230" data-md-level="1">
  128. <label class="md-nav__title" for="__nav_2">
  129. <span class="md-nav__icon md-icon"></span>
  130. LC230
  131. </label>
  132. <ul class="md-nav__list" data-md-scrollfix>
  133. <li class="md-nav__item">
  134. <a href="../../lc230/" class="md-nav__link">
  135. (LC230) Overview
  136. </a>
  137. </li>
  138. <li class="md-nav__item">
  139. <a href="../../lc230/user-guide/" class="md-nav__link">
  140. (LC230) User Guide
  141. </a>
  142. </li>
  143. <li class="md-nav__item">
  144. <a href="../../lc230/troubleshooting/" class="md-nav__link">
  145. (LC230) Troubleshooting
  146. </a>
  147. </li>
  148. </ul>
  149. </nav>
  150. </li>
  151. <li class="md-nav__item md-nav__item--active md-nav__item--nested">
  152. <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_3" type="checkbox" id="__nav_3" checked>
  153. <label class="md-nav__link" for="__nav_3">
  154. MH-USB
  155. <span class="md-nav__icon md-icon"></span>
  156. </label>
  157. <nav class="md-nav" aria-label="MH-USB" data-md-level="1">
  158. <label class="md-nav__title" for="__nav_3">
  159. <span class="md-nav__icon md-icon"></span>
  160. MH-USB
  161. </label>
  162. <ul class="md-nav__list" data-md-scrollfix>
  163. <li class="md-nav__item">
  164. <a href="../" class="md-nav__link">
  165. (MHUSB) About & Contents
  166. </a>
  167. </li>
  168. <li class="md-nav__item">
  169. <a href="../use/" class="md-nav__link">
  170. (MHUSB) Using the USB disk
  171. </a>
  172. </li>
  173. <li class="md-nav__item">
  174. <a href="../update/" class="md-nav__link">
  175. (MHUSB) Add / Update images
  176. </a>
  177. </li>
  178. <li class="md-nav__item">
  179. <a href="../internals/" class="md-nav__link">
  180. (MHUSB) Internals
  181. </a>
  182. </li>
  183. <li class="md-nav__item md-nav__item--active">
  184. <input class="md-nav__toggle md-toggle" data-md-toggle="toc" type="checkbox" id="__toc">
  185. <label class="md-nav__link md-nav__link--active" for="__toc">
  186. (MHUSB) FAQs
  187. <span class="md-nav__icon md-icon"></span>
  188. </label>
  189. <a href="./" class="md-nav__link md-nav__link--active">
  190. (MHUSB) FAQs
  191. </a>
  192. <nav class="md-nav md-nav--secondary" aria-label="Table of contents">
  193. <label class="md-nav__title" for="__toc">
  194. <span class="md-nav__icon md-icon"></span>
  195. Table of contents
  196. </label>
  197. <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
  198. <li class="md-nav__item">
  199. <a href="#boot-issues" class="md-nav__link">
  200. Boot Issues
  201. </a>
  202. <nav class="md-nav" aria-label="Boot Issues">
  203. <ul class="md-nav__list">
  204. <li class="md-nav__item">
  205. <a href="#help-the-mh-usb-wont-boot" class="md-nav__link">
  206. Help! The MH-USB won't boot!
  207. </a>
  208. </li>
  209. <li class="md-nav__item">
  210. <a href="#im-unable-to-boot-operating-system-x" class="md-nav__link">
  211. I'm unable to boot operating system X!
  212. </a>
  213. </li>
  214. <li class="md-nav__item">
  215. <a href="#i-formatted-the-disk-by-mistake-and-now-it-wont-boot" class="md-nav__link">
  216. I formatted the disk by mistake and now it won't boot!
  217. </a>
  218. </li>
  219. </ul>
  220. </nav>
  221. </li>
  222. <li class="md-nav__item">
  223. <a href="#mh-usb-questions" class="md-nav__link">
  224. MH-USB Questions
  225. </a>
  226. <nav class="md-nav" aria-label="MH-USB Questions">
  227. <ul class="md-nav__list">
  228. <li class="md-nav__item">
  229. <a href="#can-i-use-it-as-a-portable-storage-device" class="md-nav__link">
  230. Can I use it as a portable storage device?
  231. </a>
  232. </li>
  233. <li class="md-nav__item">
  234. <a href="#does-the-mh-usb-require-upgrades" class="md-nav__link">
  235. Does the MH-USB require upgrades?
  236. </a>
  237. </li>
  238. <li class="md-nav__item">
  239. <a href="#the-mh-usb-is-slow" class="md-nav__link">
  240. The MH-USB is slow!
  241. </a>
  242. </li>
  243. <li class="md-nav__item">
  244. <a href="#i-really-like-the-3d-printed-disk-how-do-i-customise-its-looks" class="md-nav__link">
  245. I really like the 3D printed disk. How do I customise its looks?
  246. </a>
  247. </li>
  248. <li class="md-nav__item">
  249. <a href="#can-you-send-me-a-usb-disk-with-the-os-images-i-need" class="md-nav__link">
  250. Can you send me a USB disk with the OS images I need?
  251. </a>
  252. </li>
  253. </ul>
  254. </nav>
  255. </li>
  256. </ul>
  257. </nav>
  258. </li>
  259. </ul>
  260. </nav>
  261. </li>
  262. <li class="md-nav__item md-nav__item--nested">
  263. <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_4" type="checkbox" id="__nav_4" >
  264. <label class="md-nav__link" for="__nav_4">
  265. Routers
  266. <span class="md-nav__icon md-icon"></span>
  267. </label>
  268. <nav class="md-nav" aria-label="Routers" data-md-level="1">
  269. <label class="md-nav__title" for="__nav_4">
  270. <span class="md-nav__icon md-icon"></span>
  271. Routers
  272. </label>
  273. <ul class="md-nav__list" data-md-scrollfix>
  274. <li class="md-nav__item">
  275. <a href="../../routers/" class="md-nav__link">
  276. Introduction
  277. </a>
  278. </li>
  279. <li class="md-nav__item">
  280. <a href="../../routers/first-use/" class="md-nav__link">
  281. First Use
  282. </a>
  283. </li>
  284. <li class="md-nav__item">
  285. <a href="../../routers/next-steps/" class="md-nav__link">
  286. Next Steps
  287. </a>
  288. </li>
  289. <li class="md-nav__item">
  290. <a href="../../routers/optional-steps/" class="md-nav__link">
  291. Optional Steps
  292. </a>
  293. </li>
  294. <li class="md-nav__item">
  295. <a href="../../routers/cli/" class="md-nav__link">
  296. Command Line Guide
  297. </a>
  298. </li>
  299. <li class="md-nav__item">
  300. <a href="../../routers/upgrade/" class="md-nav__link">
  301. Upgrading OpenWrt
  302. </a>
  303. </li>
  304. </ul>
  305. </nav>
  306. </li>
  307. <li class="md-nav__item md-nav__item--nested">
  308. <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_5" type="checkbox" id="__nav_5" >
  309. <label class="md-nav__link" for="__nav_5">
  310. Phones
  311. <span class="md-nav__icon md-icon"></span>
  312. </label>
  313. <nav class="md-nav" aria-label="Phones" data-md-level="1">
  314. <label class="md-nav__title" for="__nav_5">
  315. <span class="md-nav__icon md-icon"></span>
  316. Phones
  317. </label>
  318. <ul class="md-nav__list" data-md-scrollfix>
  319. <li class="md-nav__item">
  320. <a href="../../phones/" class="md-nav__link">
  321. Introduction
  322. </a>
  323. </li>
  324. <li class="md-nav__item">
  325. <a href="../../phones/lineageos/" class="md-nav__link">
  326. LineageOS
  327. </a>
  328. </li>
  329. <li class="md-nav__item">
  330. <a href="../../phones/f-droid/" class="md-nav__link">
  331. F-Droid
  332. </a>
  333. </li>
  334. <li class="md-nav__item">
  335. <a href="../../phones/first-use/" class="md-nav__link">
  336. First Use
  337. </a>
  338. </li>
  339. <li class="md-nav__item">
  340. <a href="../../phones/applications/" class="md-nav__link">
  341. Applications
  342. </a>
  343. </li>
  344. <li class="md-nav__item">
  345. <a href="../../phones/services/" class="md-nav__link">
  346. Services
  347. </a>
  348. </li>
  349. <li class="md-nav__item">
  350. <a href="../../phones/backups/" class="md-nav__link">
  351. Taking Backups
  352. </a>
  353. </li>
  354. <li class="md-nav__item">
  355. <a href="../../phones/recovery/" class="md-nav__link">
  356. Using Recovery
  357. </a>
  358. </li>
  359. <li class="md-nav__item">
  360. <a href="../../phones/ubports/" class="md-nav__link">
  361. Installing Ubports
  362. </a>
  363. </li>
  364. <li class="md-nav__item">
  365. <a href="../../phones/calyxos/" class="md-nav__link">
  366. Installing CalyxOS
  367. </a>
  368. </li>
  369. </ul>
  370. </nav>
  371. </li>
  372. </ul>
  373. </nav>
  374. </div>
  375. </div>
  376. </div>
  377. <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
  378. <div class="md-sidebar__scrollwrap">
  379. <div class="md-sidebar__inner">
  380. <nav class="md-nav md-nav--secondary" aria-label="Table of contents">
  381. <label class="md-nav__title" for="__toc">
  382. <span class="md-nav__icon md-icon"></span>
  383. Table of contents
  384. </label>
  385. <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
  386. <li class="md-nav__item">
  387. <a href="#boot-issues" class="md-nav__link">
  388. Boot Issues
  389. </a>
  390. <nav class="md-nav" aria-label="Boot Issues">
  391. <ul class="md-nav__list">
  392. <li class="md-nav__item">
  393. <a href="#help-the-mh-usb-wont-boot" class="md-nav__link">
  394. Help! The MH-USB won't boot!
  395. </a>
  396. </li>
  397. <li class="md-nav__item">
  398. <a href="#im-unable-to-boot-operating-system-x" class="md-nav__link">
  399. I'm unable to boot operating system X!
  400. </a>
  401. </li>
  402. <li class="md-nav__item">
  403. <a href="#i-formatted-the-disk-by-mistake-and-now-it-wont-boot" class="md-nav__link">
  404. I formatted the disk by mistake and now it won't boot!
  405. </a>
  406. </li>
  407. </ul>
  408. </nav>
  409. </li>
  410. <li class="md-nav__item">
  411. <a href="#mh-usb-questions" class="md-nav__link">
  412. MH-USB Questions
  413. </a>
  414. <nav class="md-nav" aria-label="MH-USB Questions">
  415. <ul class="md-nav__list">
  416. <li class="md-nav__item">
  417. <a href="#can-i-use-it-as-a-portable-storage-device" class="md-nav__link">
  418. Can I use it as a portable storage device?
  419. </a>
  420. </li>
  421. <li class="md-nav__item">
  422. <a href="#does-the-mh-usb-require-upgrades" class="md-nav__link">
  423. Does the MH-USB require upgrades?
  424. </a>
  425. </li>
  426. <li class="md-nav__item">
  427. <a href="#the-mh-usb-is-slow" class="md-nav__link">
  428. The MH-USB is slow!
  429. </a>
  430. </li>
  431. <li class="md-nav__item">
  432. <a href="#i-really-like-the-3d-printed-disk-how-do-i-customise-its-looks" class="md-nav__link">
  433. I really like the 3D printed disk. How do I customise its looks?
  434. </a>
  435. </li>
  436. <li class="md-nav__item">
  437. <a href="#can-you-send-me-a-usb-disk-with-the-os-images-i-need" class="md-nav__link">
  438. Can you send me a USB disk with the OS images I need?
  439. </a>
  440. </li>
  441. </ul>
  442. </nav>
  443. </li>
  444. </ul>
  445. </nav>
  446. </div>
  447. </div>
  448. </div>
  449. <div class="md-content" data-md-component="content">
  450. <article class="md-content__inner md-typeset">
  451. <h1 id="troubleshooting-faqs">Troubleshooting &amp; FAQs<a class="headerlink" href="#troubleshooting-faqs" title="Permanent link">&para;</a></h1>
  452. <h2 id="boot-issues">Boot Issues<a class="headerlink" href="#boot-issues" title="Permanent link">&para;</a></h2>
  453. <h3 id="help-the-mh-usb-wont-boot">Help! The MH-USB won't boot!<a class="headerlink" href="#help-the-mh-usb-wont-boot" title="Permanent link">&para;</a></h3>
  454. <p>First don't panic! :) </p>
  455. <p>Try out the following steps:</p>
  456. <ol>
  457. <li>
  458. <p>If you insert the USB disk into a computer, does it show up?</p>
  459. <p>A quick way to test this out on a GNU/Linux system would be to run <code>lsblk</code>
  460. or check <code>dmesg</code>.</p>
  461. </li>
  462. <li>
  463. <p>If the USB does not get detected, then it could either be an issue with
  464. your USB disk. (Or, at times, the USB port / hub.) See if it gets detected
  465. in other computers. Or change the USB port. Or try to use it without a USB
  466. hub (if you're using one).</p>
  467. <p>Still nothing? Do write in to us at <a href="&#109;&#97;&#105;&#108;&#116;&#111;&#58;&#103;&#117;&#105;&#100;&#101;&#64;&#109;&#111;&#115;&#116;&#108;&#121;&#104;&#97;&#114;&#109;&#108;&#101;&#115;&#115;&#46;&#105;&#111;">&#103;&#117;&#105;&#100;&#101;&#64;&#109;&#111;&#115;&#116;&#108;&#121;&#104;&#97;&#114;&#109;&#108;&#101;&#115;&#115;&#46;&#105;&#111;</a> with
  468. "MH-USB" somewhere in the email subject and we'll help you out.</p>
  469. <p>The <a href="https://ask.libre.support/c/usb/">MH-USB discussion forum</a> is another
  470. option.</p>
  471. </li>
  472. <li>
  473. <p>If it does get detected, then try to mount the partition called "MH-USB".<br />
  474. It should get mounted just fine on any OS. If you're able to mount this
  475. filesystem, check its contents.</p>
  476. </li>
  477. <li>
  478. <p>If the contents are okay and readable, then its probably a Grub2 issue.<br />
  479. Unless you want to debug it and learn about Grub and Ventoy in this
  480. process, that one option.</p>
  481. <p>Otherwise, a simple solution might be to just
  482. backup the contents of the USB disk and re-install the MH-USB software
  483. using the scripts included with the source code.</p>
  484. </li>
  485. </ol>
  486. <h3 id="im-unable-to-boot-operating-system-x">I'm unable to boot operating system X!<a class="headerlink" href="#im-unable-to-boot-operating-system-x" title="Permanent link">&para;</a></h3>
  487. <p>That could happen due to multiple reasons:</p>
  488. <ol>
  489. <li>
  490. <p>Its possible that the OS image on the disk has errors in it. The easiest
  491. way to verify that is to calculate and verify its checksum. </p>
  492. </li>
  493. <li>
  494. <p>When using SeaBIOS with Coreboot, it possible that the OS image might not
  495. be able to initialise graphics mode and show its internal boot menu. Try
  496. pressing the <span class="keys"><kbd class="key-tab">Tab</kbd></span> key twice to show boot options.</p>
  497. </li>
  498. <li>
  499. <p>Does Ventoy include support for that operating system? The list of
  500. supported (ie. tested out) operating systems is available here:
  501. <a href="https://www.ventoy.net/en/isolist.html">https://www.ventoy.net/en/isolist.html</a></p>
  502. </li>
  503. </ol>
  504. <p>If you still face problems, please do post on the <a href="https://ask.libre.support/c/usb/">MH-USB discussion
  505. forum</a> so that we can try to debug it
  506. together.</p>
  507. <h3 id="i-formatted-the-disk-by-mistake-and-now-it-wont-boot">I formatted the disk by mistake and now it won't boot!<a class="headerlink" href="#i-formatted-the-disk-by-mistake-and-now-it-wont-boot" title="Permanent link">&para;</a></h3>
  508. <p>You can easily recreate the MH-USB on the USB disk (or, for that matter, any
  509. USB disk out there!) by using the scripts provided with the source code.</p>
  510. <h2 id="mh-usb-questions">MH-USB Questions<a class="headerlink" href="#mh-usb-questions" title="Permanent link">&para;</a></h2>
  511. <h3 id="can-i-use-it-as-a-portable-storage-device">Can I use it as a portable storage device?<a class="headerlink" href="#can-i-use-it-as-a-portable-storage-device" title="Permanent link">&para;</a></h3>
  512. <p>Yes - Sure. The reason the MH-USB partition is formatted as exFAT is so that
  513. its possible to detect and use it on all operating systems. You can store any
  514. data on it and use it to transfer files.</p>
  515. <div class="admonition warning">
  516. <p class="admonition-title">Warning</p>
  517. <p>It is not safe to store important or private or sensitive data on a
  518. portable USB disk. Please be careful. Consider encrypting the storage disk
  519. if you need to secure the data stored on it.</p>
  520. </div>
  521. <h3 id="does-the-mh-usb-require-upgrades">Does the MH-USB require upgrades?<a class="headerlink" href="#does-the-mh-usb-require-upgrades" title="Permanent link">&para;</a></h3>
  522. <p>Not really. The MH-USB is basically a Grub2 bootable disk which in turn loads
  523. and boots up operating system images. In case there is a specific bug that
  524. stops it from working, there isn't any real reason to upgrade Venoty/Grub.</p>
  525. <p>However, if you are interested in contributing to the development effort or
  526. further customising the MH-USB - that's a good reason to upgrade / update its
  527. configuration.</p>
  528. <h3 id="the-mh-usb-is-slow">The MH-USB is slow!<a class="headerlink" href="#the-mh-usb-is-slow" title="Permanent link">&para;</a></h3>
  529. <p>Check the <a href="/usb/internals/#dd-read-test">performance benchmarks</a> for the USB2
  530. model. Try to replicate them and see if your results come close to it. That
  531. would indicate a limit of the USB disk's performance.</p>
  532. <p>If you have a USB3 disk and connecting it to a USB2 port, that might result in
  533. slower transfer speeds as well. Do check that out.</p>
  534. <h3 id="i-really-like-the-3d-printed-disk-how-do-i-customise-its-looks">I really like the 3D printed disk. How do I customise its looks?<a class="headerlink" href="#i-really-like-the-3d-printed-disk-how-do-i-customise-its-looks" title="Permanent link">&para;</a></h3>
  535. <p>Yes sure! By all means. The source code for the 3D printed enclosure is
  536. included within the MH-USB source code.</p>
  537. <p>If you need help with design, production, customisation or distribution, please
  538. feel free to reach out.</p>
  539. <h3 id="can-you-send-me-a-usb-disk-with-the-os-images-i-need">Can you send me a USB disk with the OS images I need?<a class="headerlink" href="#can-you-send-me-a-usb-disk-with-the-os-images-i-need" title="Permanent link">&para;</a></h3>
  540. <p>MH-USB variants with custom images would require too much effort - unless what
  541. you have is a volume requirement (ie. at least 100 units). You can make your
  542. own custom USB disk very easily by adding the OS images of your choice and
  543. customising the Grub2 theme.</p>
  544. </article>
  545. </div>
  546. </div>
  547. </main>
  548. <footer class="md-footer">
  549. <nav class="md-footer__inner md-grid" aria-label="Footer">
  550. <a href="../internals/" class="md-footer__link md-footer__link--prev" aria-label="Previous: (MHUSB) Internals" rel="prev">
  551. <div class="md-footer__button md-icon">
  552. <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>
  553. </div>
  554. <div class="md-footer__title">
  555. <div class="md-ellipsis">
  556. <span class="md-footer__direction">
  557. Previous
  558. </span>
  559. (MHUSB) Internals
  560. </div>
  561. </div>
  562. </a>
  563. <a href="../../routers/" class="md-footer__link md-footer__link--next" aria-label="Next: Introduction" rel="next">
  564. <div class="md-footer__title">
  565. <div class="md-ellipsis">
  566. <span class="md-footer__direction">
  567. Next
  568. </span>
  569. Introduction
  570. </div>
  571. </div>
  572. <div class="md-footer__button md-icon">
  573. <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>
  574. </div>
  575. </a>
  576. </nav>
  577. <div class="md-footer-meta md-typeset">
  578. <div class="md-footer-meta__inner md-grid">
  579. <div class="md-copyright">
  580. <div class="md-copyright__highlight">
  581. Copyright &copy; Mostly Harmless
  582. </div>
  583. Made with
  584. <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
  585. Material for MkDocs
  586. </a>
  587. </div>
  588. </div>
  589. </div>
  590. </footer>
  591. </div>
  592. <div class="md-dialog" data-md-component="dialog">
  593. <div class="md-dialog__inner md-typeset"></div>
  594. </div>
  595. <script id="__config" type="application/json">{"base": "../..", "features": [], "translations": {"clipboard.copy": "Copy to clipboard", "clipboard.copied": "Copied to clipboard", "search.config.lang": "en", "search.config.pipeline": "trimmer, stopWordFilter", "search.config.separator": "[\\s\\-]+", "search.placeholder": "Search", "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", "select.version.title": "Select version"}, "search": "../../assets/javascripts/workers/search.22074ed6.min.js"}</script>
  596. <script src="../../assets/javascripts/bundle.01de222e.min.js"></script>
  597. </body>
  598. </html>