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.

1262 lines
28 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="mergerfs - a featureful union filesystem">
  7. <link rel="canonical" href="https://trapexit.github.io/mergerfs/setup/upgrade/">
  8. <link rel="prev" href="../installation/">
  9. <link rel="next" href="../build/">
  10. <link rel="icon" href="../../assets/images/favicon.png">
  11. <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
  12. <title>Upgrade - mergerfs</title>
  13. <link rel="stylesheet" href="../../assets/stylesheets/main.6f8fc17f.min.css">
  14. <link rel="stylesheet" href="../../assets/stylesheets/palette.06af60db.min.css">
  15. <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
  16. <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
  17. <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
  18. <script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__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>
  19. </head>
  20. <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="indigo" data-md-color-accent="indigo">
  21. <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
  22. <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
  23. <label class="md-overlay" for="__drawer"></label>
  24. <div data-md-component="skip">
  25. <a href="#upgrade" class="md-skip">
  26. Skip to content
  27. </a>
  28. </div>
  29. <div data-md-component="announce">
  30. </div>
  31. <header class="md-header md-header--shadow" data-md-component="header">
  32. <nav class="md-header__inner md-grid" aria-label="Header">
  33. <a href="../.." title="mergerfs" class="md-header__button md-logo" aria-label="mergerfs" data-md-component="logo">
  34. <img src="../../logo.jpeg" alt="logo">
  35. </a>
  36. <label class="md-header__button md-icon" for="__drawer">
  37. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg>
  38. </label>
  39. <div class="md-header__title" data-md-component="header-title">
  40. <div class="md-header__ellipsis">
  41. <div class="md-header__topic">
  42. <span class="md-ellipsis">
  43. mergerfs
  44. </span>
  45. </div>
  46. <div class="md-header__topic" data-md-component="header-topic">
  47. <span class="md-ellipsis">
  48. Upgrade
  49. </span>
  50. </div>
  51. </div>
  52. </div>
  53. <form class="md-header__option" data-md-component="palette">
  54. <input class="md-option" data-md-color-media="(prefers-color-scheme)" data-md-color-scheme="default" data-md-color-primary="indigo" data-md-color-accent="indigo" aria-label="Switch to light mode" type="radio" name="__palette" id="__palette_0">
  55. <label class="md-header__button md-icon" title="Switch to light mode" for="__palette_1" hidden>
  56. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m14.3 16-.7-2h-3.2l-.7 2H7.8L11 7h2l3.2 9zM20 8.69V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12zm-9.15 3.96h2.3L12 9z"/></svg>
  57. </label>
  58. <input class="md-option" data-md-color-media="(prefers-color-scheme: light)" data-md-color-scheme="default" data-md-color-primary="indigo" data-md-color-accent="indigo" aria-label="Switch to dark mode" type="radio" name="__palette" id="__palette_1">
  59. <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_2" hidden>
  60. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>
  61. </label>
  62. <input class="md-option" data-md-color-media="(prefers-color-scheme: dark)" data-md-color-scheme="slate" data-md-color-primary="indigo" data-md-color-accent="indigo" aria-label="Switch to system preference" type="radio" name="__palette" id="__palette_2">
  63. <label class="md-header__button md-icon" title="Switch to system preference" for="__palette_0" hidden>
  64. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12s-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>
  65. </label>
  66. </form>
  67. <script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
  68. <label class="md-header__button md-icon" for="__search">
  69. <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.52 6.52 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 5"/></svg>
  70. </label>
  71. <div class="md-search" data-md-component="search" role="dialog">
  72. <label class="md-search__overlay" for="__search"></label>
  73. <div class="md-search__inner" role="search">
  74. <form class="md-search__form" name="search">
  75. <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>
  76. <label class="md-search__icon md-icon" for="__search">
  77. <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.52 6.52 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 5"/></svg>
  78. <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 11z"/></svg>
  79. </label>
  80. <nav class="md-search__options" aria-label="Search">
  81. <a href="javascript:void(0)" class="md-search__icon md-icon" title="Share" aria-label="Share" data-clipboard data-clipboard-text="" data-md-component="search-share" tabindex="-1">
  82. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M18 16.08c-.76 0-1.44.3-1.96.77L8.91 12.7c.05-.23.09-.46.09-.7s-.04-.47-.09-.7l7.05-4.11c.54.5 1.25.81 2.04.81a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3c0 .24.04.47.09.7L8.04 9.81C7.5 9.31 6.79 9 6 9a3 3 0 0 0-3 3 3 3 0 0 0 3 3c.79 0 1.5-.31 2.04-.81l7.12 4.15c-.05.21-.08.43-.08.66 0 1.61 1.31 2.91 2.92 2.91s2.92-1.3 2.92-2.91A2.92 2.92 0 0 0 18 16.08"/></svg>
  83. </a>
  84. <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
  85. <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 12z"/></svg>
  86. </button>
  87. </nav>
  88. </form>
  89. <div class="md-search__output">
  90. <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
  91. <div class="md-search-result" data-md-component="search-result">
  92. <div class="md-search-result__meta">
  93. Initializing search
  94. </div>
  95. <ol class="md-search-result__list" role="presentation"></ol>
  96. </div>
  97. </div>
  98. </div>
  99. </div>
  100. </div>
  101. <div class="md-header__source">
  102. <a href="https://github.com/trapexit/mergerfs" title="Go to repository" class="md-source" data-md-component="source">
  103. <div class="md-source__icon md-icon">
  104. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><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.81"/></svg>
  105. </div>
  106. <div class="md-source__repository">
  107. mergerfs
  108. </div>
  109. </a>
  110. </div>
  111. </nav>
  112. </header>
  113. <div class="md-container" data-md-component="container">
  114. <main class="md-main" data-md-component="main">
  115. <div class="md-main__inner md-grid">
  116. <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
  117. <div class="md-sidebar__scrollwrap">
  118. <div class="md-sidebar__inner">
  119. <nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
  120. <label class="md-nav__title" for="__drawer">
  121. <a href="../.." title="mergerfs" class="md-nav__button md-logo" aria-label="mergerfs" data-md-component="logo">
  122. <img src="../../logo.jpeg" alt="logo">
  123. </a>
  124. mergerfs
  125. </label>
  126. <div class="md-nav__source">
  127. <a href="https://github.com/trapexit/mergerfs" title="Go to repository" class="md-source" data-md-component="source">
  128. <div class="md-source__icon md-icon">
  129. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><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.81"/></svg>
  130. </div>
  131. <div class="md-source__repository">
  132. mergerfs
  133. </div>
  134. </a>
  135. </div>
  136. <ul class="md-nav__list" data-md-scrollfix>
  137. <li class="md-nav__item">
  138. <a href="../.." class="md-nav__link">
  139. <span class="md-ellipsis">
  140. Home
  141. </span>
  142. </a>
  143. </li>
  144. <li class="md-nav__item">
  145. <a href="../../quickstart/" class="md-nav__link">
  146. <span class="md-ellipsis">
  147. QuickStart
  148. </span>
  149. </a>
  150. </li>
  151. <li class="md-nav__item md-nav__item--active md-nav__item--nested">
  152. <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" checked>
  153. <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
  154. <span class="md-ellipsis">
  155. Installation
  156. </span>
  157. <span class="md-nav__icon md-icon"></span>
  158. </label>
  159. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="true">
  160. <label class="md-nav__title" for="__nav_3">
  161. <span class="md-nav__icon md-icon"></span>
  162. Installation
  163. </label>
  164. <ul class="md-nav__list" data-md-scrollfix>
  165. <li class="md-nav__item">
  166. <a href="../installation/" class="md-nav__link">
  167. <span class="md-ellipsis">
  168. Installation
  169. </span>
  170. </a>
  171. </li>
  172. <li class="md-nav__item md-nav__item--active">
  173. <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
  174. <a href="./" class="md-nav__link md-nav__link--active">
  175. <span class="md-ellipsis">
  176. Upgrade
  177. </span>
  178. </a>
  179. </li>
  180. <li class="md-nav__item">
  181. <a href="../build/" class="md-nav__link">
  182. <span class="md-ellipsis">
  183. Build
  184. </span>
  185. </a>
  186. </li>
  187. </ul>
  188. </nav>
  189. </li>
  190. <li class="md-nav__item md-nav__item--nested">
  191. <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
  192. <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
  193. <span class="md-ellipsis">
  194. Config
  195. </span>
  196. <span class="md-nav__icon md-icon"></span>
  197. </label>
  198. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
  199. <label class="md-nav__title" for="__nav_4">
  200. <span class="md-nav__icon md-icon"></span>
  201. Config
  202. </label>
  203. <ul class="md-nav__list" data-md-scrollfix>
  204. <li class="md-nav__item">
  205. <a href="../../config/terminology/" class="md-nav__link">
  206. <span class="md-ellipsis">
  207. Terminology
  208. </span>
  209. </a>
  210. </li>
  211. <li class="md-nav__item">
  212. <a href="../../config/options/" class="md-nav__link">
  213. <span class="md-ellipsis">
  214. Options
  215. </span>
  216. </a>
  217. </li>
  218. <li class="md-nav__item">
  219. <a href="../../config/deprecated_options/" class="md-nav__link">
  220. <span class="md-ellipsis">
  221. Deprecated Options
  222. </span>
  223. </a>
  224. </li>
  225. <li class="md-nav__item">
  226. <a href="../../config/branches/" class="md-nav__link">
  227. <span class="md-ellipsis">
  228. branches
  229. </span>
  230. </a>
  231. </li>
  232. <li class="md-nav__item">
  233. <a href="../../config/functions_categories_and_policies/" class="md-nav__link">
  234. <span class="md-ellipsis">
  235. functions, categories and policies
  236. </span>
  237. </a>
  238. </li>
  239. <li class="md-nav__item">
  240. <a href="../../config/func_readdir/" class="md-nav__link">
  241. <span class="md-ellipsis">
  242. func.readdir
  243. </span>
  244. </a>
  245. </li>
  246. <li class="md-nav__item">
  247. <a href="../../config/cache/" class="md-nav__link">
  248. <span class="md-ellipsis">
  249. caching
  250. </span>
  251. </a>
  252. </li>
  253. <li class="md-nav__item">
  254. <a href="../../config/ioctl/" class="md-nav__link">
  255. <span class="md-ellipsis">
  256. ioctl
  257. </span>
  258. </a>
  259. </li>
  260. <li class="md-nav__item">
  261. <a href="../../config/rename_and_link/" class="md-nav__link">
  262. <span class="md-ellipsis">
  263. rename and link
  264. </span>
  265. </a>
  266. </li>
  267. <li class="md-nav__item">
  268. <a href="../../config/statfs/" class="md-nav__link">
  269. <span class="md-ellipsis">
  270. statfs / statvfs
  271. </span>
  272. </a>
  273. </li>
  274. <li class="md-nav__item">
  275. <a href="../../config/flush-on-close/" class="md-nav__link">
  276. <span class="md-ellipsis">
  277. flush-on-close
  278. </span>
  279. </a>
  280. </li>
  281. </ul>
  282. </nav>
  283. </li>
  284. <li class="md-nav__item">
  285. <a href="../../error_handling/" class="md-nav__link">
  286. <span class="md-ellipsis">
  287. Error Handling
  288. </span>
  289. </a>
  290. </li>
  291. <li class="md-nav__item">
  292. <a href="../../runtime_interfaces/" class="md-nav__link">
  293. <span class="md-ellipsis">
  294. Runtime Interfaces
  295. </span>
  296. </a>
  297. </li>
  298. <li class="md-nav__item">
  299. <a href="../../remote_filesystems/" class="md-nav__link">
  300. <span class="md-ellipsis">
  301. Remote Filesystems
  302. </span>
  303. </a>
  304. </li>
  305. <li class="md-nav__item">
  306. <a href="../../tips_notes/" class="md-nav__link">
  307. <span class="md-ellipsis">
  308. Tips and Notes
  309. </span>
  310. </a>
  311. </li>
  312. <li class="md-nav__item">
  313. <a href="../../known_issues_bugs/" class="md-nav__link">
  314. <span class="md-ellipsis">
  315. Known Issues and Bugs
  316. </span>
  317. </a>
  318. </li>
  319. <li class="md-nav__item">
  320. <a href="../../project_comparisons/" class="md-nav__link">
  321. <span class="md-ellipsis">
  322. Project Comparisons
  323. </span>
  324. </a>
  325. </li>
  326. <li class="md-nav__item">
  327. <a href="../../performance/" class="md-nav__link">
  328. <span class="md-ellipsis">
  329. Tweaking Performance
  330. </span>
  331. </a>
  332. </li>
  333. <li class="md-nav__item">
  334. <a href="../../benchmarking/" class="md-nav__link">
  335. <span class="md-ellipsis">
  336. Benchmarking
  337. </span>
  338. </a>
  339. </li>
  340. <li class="md-nav__item">
  341. <a href="../../tooling/" class="md-nav__link">
  342. <span class="md-ellipsis">
  343. Tooling
  344. </span>
  345. </a>
  346. </li>
  347. <li class="md-nav__item md-nav__item--nested">
  348. <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_14" >
  349. <label class="md-nav__link" for="__nav_14" id="__nav_14_label" tabindex="0">
  350. <span class="md-ellipsis">
  351. FAQ
  352. </span>
  353. <span class="md-nav__icon md-icon"></span>
  354. </label>
  355. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_14_label" aria-expanded="false">
  356. <label class="md-nav__title" for="__nav_14">
  357. <span class="md-nav__icon md-icon"></span>
  358. FAQ
  359. </label>
  360. <ul class="md-nav__list" data-md-scrollfix>
  361. <li class="md-nav__item">
  362. <a href="../../faq/compatibility_and_integration/" class="md-nav__link">
  363. <span class="md-ellipsis">
  364. Compatibility and Integration
  365. </span>
  366. </a>
  367. </li>
  368. <li class="md-nav__item">
  369. <a href="../../faq/configuration_and_policies/" class="md-nav__link">
  370. <span class="md-ellipsis">
  371. Configuration and Policies
  372. </span>
  373. </a>
  374. </li>
  375. <li class="md-nav__item">
  376. <a href="../../faq/general_information_and_overview/" class="md-nav__link">
  377. <span class="md-ellipsis">
  378. General Information and Overview
  379. </span>
  380. </a>
  381. </li>
  382. <li class="md-nav__item">
  383. <a href="../../faq/recommendations_and_warnings/" class="md-nav__link">
  384. <span class="md-ellipsis">
  385. Recommendations and Warnings
  386. </span>
  387. </a>
  388. </li>
  389. <li class="md-nav__item">
  390. <a href="../../faq/technical_behavior_and_limitations/" class="md-nav__link">
  391. <span class="md-ellipsis">
  392. Technical Behavior and Limitations
  393. </span>
  394. </a>
  395. </li>
  396. <li class="md-nav__item">
  397. <a href="../../faq/usage_and_functionality/" class="md-nav__link">
  398. <span class="md-ellipsis">
  399. Usage and Functionality
  400. </span>
  401. </a>
  402. </li>
  403. <li class="md-nav__item">
  404. <a href="../../faq/limit_drive_spinup/" class="md-nav__link">
  405. <span class="md-ellipsis">
  406. Limit drive spinup
  407. </span>
  408. </a>
  409. </li>
  410. </ul>
  411. </nav>
  412. </li>
  413. <li class="md-nav__item">
  414. <a href="../../related_projects/" class="md-nav__link">
  415. <span class="md-ellipsis">
  416. Related Projects
  417. </span>
  418. </a>
  419. </li>
  420. <li class="md-nav__item">
  421. <a href="../../media_and_publicity/" class="md-nav__link">
  422. <span class="md-ellipsis">
  423. Media and Publicity
  424. </span>
  425. </a>
  426. </li>
  427. <li class="md-nav__item">
  428. <a href="../../support/" class="md-nav__link">
  429. <span class="md-ellipsis">
  430. Support
  431. </span>
  432. </a>
  433. </li>
  434. <li class="md-nav__item">
  435. <a href="../../donations/" class="md-nav__link">
  436. <span class="md-ellipsis">
  437. Donations
  438. </span>
  439. </a>
  440. </li>
  441. </ul>
  442. </nav>
  443. </div>
  444. </div>
  445. </div>
  446. <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
  447. <div class="md-sidebar__scrollwrap">
  448. <div class="md-sidebar__inner">
  449. <nav class="md-nav md-nav--secondary" aria-label="Table of contents">
  450. </nav>
  451. </div>
  452. </div>
  453. </div>
  454. <div class="md-content" data-md-component="content">
  455. <article class="md-content__inner md-typeset">
  456. <a href="https://github.com/trapexit/mergerfs/tree/master/mkdocs/docs/setup/upgrade.md" title="Edit this page" class="md-content__button md-icon">
  457. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4zm10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1z"/></svg>
  458. </a>
  459. <h1 id="upgrade">Upgrade</h1>
  460. <p>mergerfs can be upgraded live by mounting on top of the previous
  461. instance. Simply install the new version of mergerfs and follow the
  462. instructions below.</p>
  463. <p>Run mergerfs again or if using <code>/etc/fstab</code> call for it to mount
  464. again. Existing open files and such will continue to work fine though
  465. they won't see runtime changes since any such change would be the new
  466. mount. If you plan on changing settings with the new mount you should
  467. / could apply those before mounting the new version.</p>
  468. <div class="language-text highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>$ sudo mount /mnt/mergerfs
  469. </span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a>$ mount | grep mergerfs
  470. </span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a>media on /mnt/mergerfs type mergerfs (rw,relatime,user_id=0,group_id=0,default_permissions,allow_other)
  471. </span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a>media on /mnt/mergerfs type mergerfs (rw,relatime,user_id=0,group_id=0,default_permissions,allow_other)
  472. </span></code></pre></div>
  473. <p>A problem with this approach is that the underlying instance will
  474. continue to run even if the software using it stop or are
  475. restarted. To work around this you can use a "lazy umount". Before
  476. mounting over top the mount point with the new instance of mergerfs
  477. issue: <code>umount -l &lt;mergerfs_mountpoint&gt;</code>. Or you can let mergerfs do
  478. it by setting the option <code>lazy-umount-mountpoint=true</code>.</p>
  479. </article>
  480. </div>
  481. <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
  482. </div>
  483. <button type="button" class="md-top md-icon" data-md-component="top" hidden>
  484. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8z"/></svg>
  485. Back to top
  486. </button>
  487. </main>
  488. <footer class="md-footer">
  489. <div class="md-footer-meta md-typeset">
  490. <div class="md-footer-meta__inner md-grid">
  491. <div class="md-copyright">
  492. Made with
  493. <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
  494. Material for MkDocs
  495. </a>
  496. </div>
  497. </div>
  498. </div>
  499. </footer>
  500. </div>
  501. <div class="md-dialog" data-md-component="dialog">
  502. <div class="md-dialog__inner md-typeset"></div>
  503. </div>
  504. <script id="__config" type="application/json">{"base": "../..", "features": ["content.action.edit", "content.code.copy", "content.code.select", "navigation.instant", "navigation.instant.prefetch", "navigation.path", "navigation.top", "navigation.tracking", "optimize", "search.share", "toc.follow"], "search": "../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
  505. <script src="../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
  506. </body>
  507. </html>