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.

1354 lines
27 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/">
  8. <link rel="next" href="pages/documentation/how_it_works/">
  9. <link rel="icon" href="assets/images/favicon.png">
  10. <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
  11. <title>mergerfs</title>
  12. <link rel="stylesheet" href="assets/stylesheets/main.6f8fc17f.min.css">
  13. <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
  14. <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">
  15. <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
  16. <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>
  17. </head>
  18. <body dir="ltr">
  19. <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
  20. <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
  21. <label class="md-overlay" for="__drawer"></label>
  22. <div data-md-component="skip">
  23. <a href="#mergerfs-a-featureful-union-filesystem" class="md-skip">
  24. Skip to content
  25. </a>
  26. </div>
  27. <div data-md-component="announce">
  28. </div>
  29. <header class="md-header md-header--shadow" data-md-component="header">
  30. <nav class="md-header__inner md-grid" aria-label="Header">
  31. <a href="." title="mergerfs" class="md-header__button md-logo" aria-label="mergerfs" data-md-component="logo">
  32. <img src="logo.jpeg" alt="logo">
  33. </a>
  34. <label class="md-header__button md-icon" for="__drawer">
  35. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg>
  36. </label>
  37. <div class="md-header__title" data-md-component="header-title">
  38. <div class="md-header__ellipsis">
  39. <div class="md-header__topic">
  40. <span class="md-ellipsis">
  41. mergerfs
  42. </span>
  43. </div>
  44. <div class="md-header__topic" data-md-component="header-topic">
  45. <span class="md-ellipsis">
  46. About
  47. </span>
  48. </div>
  49. </div>
  50. </div>
  51. <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>
  52. <label class="md-header__button md-icon" for="__search">
  53. <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>
  54. </label>
  55. <div class="md-search" data-md-component="search" role="dialog">
  56. <label class="md-search__overlay" for="__search"></label>
  57. <div class="md-search__inner" role="search">
  58. <form class="md-search__form" name="search">
  59. <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>
  60. <label class="md-search__icon md-icon" for="__search">
  61. <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>
  62. <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>
  63. </label>
  64. <nav class="md-search__options" aria-label="Search">
  65. <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
  66. <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>
  67. </button>
  68. </nav>
  69. </form>
  70. <div class="md-search__output">
  71. <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
  72. <div class="md-search-result" data-md-component="search-result">
  73. <div class="md-search-result__meta">
  74. Initializing search
  75. </div>
  76. <ol class="md-search-result__list" role="presentation"></ol>
  77. </div>
  78. </div>
  79. </div>
  80. </div>
  81. </div>
  82. <div class="md-header__source">
  83. <a href="https://github.com/trapexit/mergerfs" title="Go to repository" class="md-source" data-md-component="source">
  84. <div class="md-source__icon md-icon">
  85. <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>
  86. </div>
  87. <div class="md-source__repository">
  88. mergerfs
  89. </div>
  90. </a>
  91. </div>
  92. </nav>
  93. </header>
  94. <div class="md-container" data-md-component="container">
  95. <main class="md-main" data-md-component="main">
  96. <div class="md-main__inner md-grid">
  97. <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
  98. <div class="md-sidebar__scrollwrap">
  99. <div class="md-sidebar__inner">
  100. <nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
  101. <label class="md-nav__title" for="__drawer">
  102. <a href="." title="mergerfs" class="md-nav__button md-logo" aria-label="mergerfs" data-md-component="logo">
  103. <img src="logo.jpeg" alt="logo">
  104. </a>
  105. mergerfs
  106. </label>
  107. <div class="md-nav__source">
  108. <a href="https://github.com/trapexit/mergerfs" title="Go to repository" class="md-source" data-md-component="source">
  109. <div class="md-source__icon md-icon">
  110. <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>
  111. </div>
  112. <div class="md-source__repository">
  113. mergerfs
  114. </div>
  115. </a>
  116. </div>
  117. <ul class="md-nav__list" data-md-scrollfix>
  118. <li class="md-nav__item md-nav__item--active">
  119. <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
  120. <label class="md-nav__link md-nav__link--active" for="__toc">
  121. <span class="md-ellipsis">
  122. About
  123. </span>
  124. <span class="md-nav__icon md-icon"></span>
  125. </label>
  126. <a href="." class="md-nav__link md-nav__link--active">
  127. <span class="md-ellipsis">
  128. About
  129. </span>
  130. </a>
  131. <nav class="md-nav md-nav--secondary" aria-label="Table of contents">
  132. <label class="md-nav__title" for="__toc">
  133. <span class="md-nav__icon md-icon"></span>
  134. Table of contents
  135. </label>
  136. <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
  137. <li class="md-nav__item">
  138. <a href="#description" class="md-nav__link">
  139. <span class="md-ellipsis">
  140. DESCRIPTION
  141. </span>
  142. </a>
  143. </li>
  144. <li class="md-nav__item">
  145. <a href="#features" class="md-nav__link">
  146. <span class="md-ellipsis">
  147. FEATURES
  148. </span>
  149. </a>
  150. </li>
  151. <li class="md-nav__item">
  152. <a href="#synopsis" class="md-nav__link">
  153. <span class="md-ellipsis">
  154. SYNOPSIS
  155. </span>
  156. </a>
  157. </li>
  158. <li class="md-nav__item">
  159. <a href="#documentation" class="md-nav__link">
  160. <span class="md-ellipsis">
  161. DOCUMENTATION
  162. </span>
  163. </a>
  164. </li>
  165. <li class="md-nav__item">
  166. <a href="#tools" class="md-nav__link">
  167. <span class="md-ellipsis">
  168. TOOLS
  169. </span>
  170. </a>
  171. </li>
  172. </ul>
  173. </nav>
  174. </li>
  175. <li class="md-nav__item md-nav__item--nested">
  176. <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
  177. <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
  178. <span class="md-ellipsis">
  179. Documentation
  180. </span>
  181. <span class="md-nav__icon md-icon"></span>
  182. </label>
  183. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
  184. <label class="md-nav__title" for="__nav_2">
  185. <span class="md-nav__icon md-icon"></span>
  186. Documentation
  187. </label>
  188. <ul class="md-nav__list" data-md-scrollfix>
  189. <li class="md-nav__item">
  190. <a href="pages/documentation/how_it_works/" class="md-nav__link">
  191. <span class="md-ellipsis">
  192. HOW IT WORKS
  193. </span>
  194. </a>
  195. </li>
  196. <li class="md-nav__item">
  197. <a href="pages/documentation/terminology/" class="md-nav__link">
  198. <span class="md-ellipsis">
  199. TERMINOLOGY
  200. </span>
  201. </a>
  202. </li>
  203. <li class="md-nav__item">
  204. <a href="pages/documentation/basic_setup/" class="md-nav__link">
  205. <span class="md-ellipsis">
  206. BASIC SETUP
  207. </span>
  208. </a>
  209. </li>
  210. <li class="md-nav__item">
  211. <a href="pages/documentation/options/" class="md-nav__link">
  212. <span class="md-ellipsis">
  213. OPTIONS
  214. </span>
  215. </a>
  216. </li>
  217. <li class="md-nav__item">
  218. <a href="pages/documentation/functions_categories_and_policies/" class="md-nav__link">
  219. <span class="md-ellipsis">
  220. FUNCTIONS, CATEGORIES and POLICIES
  221. </span>
  222. </a>
  223. </li>
  224. <li class="md-nav__item">
  225. <a href="pages/documentation/error_handling/" class="md-nav__link">
  226. <span class="md-ellipsis">
  227. ERROR HANDLING
  228. </span>
  229. </a>
  230. </li>
  231. <li class="md-nav__item">
  232. <a href="pages/documentation/install/" class="md-nav__link">
  233. <span class="md-ellipsis">
  234. INSTALL
  235. </span>
  236. </a>
  237. </li>
  238. <li class="md-nav__item">
  239. <a href="pages/documentation/build/" class="md-nav__link">
  240. <span class="md-ellipsis">
  241. BUILD
  242. </span>
  243. </a>
  244. </li>
  245. <li class="md-nav__item">
  246. <a href="pages/documentation/upgrade/" class="md-nav__link">
  247. <span class="md-ellipsis">
  248. UPGRADE
  249. </span>
  250. </a>
  251. </li>
  252. <li class="md-nav__item">
  253. <a href="pages/documentation/runtime_interfaces/" class="md-nav__link">
  254. <span class="md-ellipsis">
  255. RUNTIME INTERFACES
  256. </span>
  257. </a>
  258. </li>
  259. <li class="md-nav__item">
  260. <a href="pages/documentation/tooling/" class="md-nav__link">
  261. <span class="md-ellipsis">
  262. TOOLING
  263. </span>
  264. </a>
  265. </li>
  266. <li class="md-nav__item">
  267. <a href="pages/documentation/caching/" class="md-nav__link">
  268. <span class="md-ellipsis">
  269. CACHING
  270. </span>
  271. </a>
  272. </li>
  273. <li class="md-nav__item">
  274. <a href="pages/documentation/performance/" class="md-nav__link">
  275. <span class="md-ellipsis">
  276. PERFORMANCE
  277. </span>
  278. </a>
  279. </li>
  280. <li class="md-nav__item">
  281. <a href="pages/documentation/benchmarking/" class="md-nav__link">
  282. <span class="md-ellipsis">
  283. BENCHMARKING
  284. </span>
  285. </a>
  286. </li>
  287. <li class="md-nav__item">
  288. <a href="pages/documentation/tips_notes/" class="md-nav__link">
  289. <span class="md-ellipsis">
  290. TIPS / NOTES
  291. </span>
  292. </a>
  293. </li>
  294. <li class="md-nav__item">
  295. <a href="pages/documentation/known_issues_bugs/" class="md-nav__link">
  296. <span class="md-ellipsis">
  297. KNOWN ISSUES / BUGS
  298. </span>
  299. </a>
  300. </li>
  301. <li class="md-nav__item">
  302. <a href="pages/documentation/remote_filesystems/" class="md-nav__link">
  303. <span class="md-ellipsis">
  304. Remote Filesystems
  305. </span>
  306. </a>
  307. </li>
  308. <li class="md-nav__item">
  309. <a href="pages/documentation/mergerfs_versus_x/" class="md-nav__link">
  310. <span class="md-ellipsis">
  311. mergerfs versus X
  312. </span>
  313. </a>
  314. </li>
  315. <li class="md-nav__item">
  316. <a href="pages/documentation/support/" class="md-nav__link">
  317. <span class="md-ellipsis">
  318. SUPPORT
  319. </span>
  320. </a>
  321. </li>
  322. <li class="md-nav__item">
  323. <a href="pages/documentation/links/" class="md-nav__link">
  324. <span class="md-ellipsis">
  325. LINKS
  326. </span>
  327. </a>
  328. </li>
  329. </ul>
  330. </nav>
  331. </li>
  332. <li class="md-nav__item md-nav__item--nested">
  333. <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
  334. <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
  335. <span class="md-ellipsis">
  336. FAQ
  337. </span>
  338. <span class="md-nav__icon md-icon"></span>
  339. </label>
  340. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
  341. <label class="md-nav__title" for="__nav_3">
  342. <span class="md-nav__icon md-icon"></span>
  343. FAQ
  344. </label>
  345. <ul class="md-nav__list" data-md-scrollfix>
  346. <li class="md-nav__item">
  347. <a href="pages/faq/compatibility_and_integration/" class="md-nav__link">
  348. <span class="md-ellipsis">
  349. Compatibility and Integration
  350. </span>
  351. </a>
  352. </li>
  353. <li class="md-nav__item">
  354. <a href="pages/faq/configuration_and_policies/" class="md-nav__link">
  355. <span class="md-ellipsis">
  356. Configuration and Policies
  357. </span>
  358. </a>
  359. </li>
  360. <li class="md-nav__item">
  361. <a href="pages/faq/general_information_and_overview/" class="md-nav__link">
  362. <span class="md-ellipsis">
  363. General Information and Overview
  364. </span>
  365. </a>
  366. </li>
  367. <li class="md-nav__item">
  368. <a href="pages/faq/recommendations_and_warnings/" class="md-nav__link">
  369. <span class="md-ellipsis">
  370. Recommendations and Warnings
  371. </span>
  372. </a>
  373. </li>
  374. <li class="md-nav__item">
  375. <a href="pages/faq/technical_behavior_and_limitations/" class="md-nav__link">
  376. <span class="md-ellipsis">
  377. Technical Behavior and Limitations
  378. </span>
  379. </a>
  380. </li>
  381. <li class="md-nav__item">
  382. <a href="pages/faq/usage_and_functionality/" class="md-nav__link">
  383. <span class="md-ellipsis">
  384. Usage and Functionality
  385. </span>
  386. </a>
  387. </li>
  388. </ul>
  389. </nav>
  390. </li>
  391. <li class="md-nav__item md-nav__item--nested">
  392. <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
  393. <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
  394. <span class="md-ellipsis">
  395. Wiki
  396. </span>
  397. <span class="md-nav__icon md-icon"></span>
  398. </label>
  399. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
  400. <label class="md-nav__title" for="__nav_4">
  401. <span class="md-nav__icon md-icon"></span>
  402. Wiki
  403. </label>
  404. <ul class="md-nav__list" data-md-scrollfix>
  405. <li class="md-nav__item">
  406. <a href="pages/wiki/projects_using_mergerfs/" class="md-nav__link">
  407. <span class="md-ellipsis">
  408. Projects incorporating mergerfs directly in some way
  409. </span>
  410. </a>
  411. </li>
  412. <li class="md-nav__item">
  413. <a href="pages/wiki/installing_mergerfs_on_a_synology_nas/" class="md-nav__link">
  414. <span class="md-ellipsis">
  415. Installing mergerfs on a synology nas
  416. </span>
  417. </a>
  418. </li>
  419. <li class="md-nav__item">
  420. <a href="pages/wiki/testimonials/" class="md-nav__link">
  421. <span class="md-ellipsis">
  422. Testimonials
  423. </span>
  424. </a>
  425. </li>
  426. <li class="md-nav__item">
  427. <a href="pages/wiki/real_world_deployments/" class="md-nav__link">
  428. <span class="md-ellipsis">
  429. trapexit's (mergerfs' author)
  430. </span>
  431. </a>
  432. </li>
  433. <li class="md-nav__item">
  434. <a href="pages/wiki/systemd/" class="md-nav__link">
  435. <span class="md-ellipsis">
  436. systemd
  437. </span>
  438. </a>
  439. </li>
  440. <li class="md-nav__item">
  441. <a href="pages/wiki/kernel_issues_and_bugs/" class="md-nav__link">
  442. <span class="md-ellipsis">
  443. Kernel issues and bugs
  444. </span>
  445. </a>
  446. </li>
  447. <li class="md-nav__item">
  448. <a href="pages/wiki/featured_media_and_publicity/" class="md-nav__link">
  449. <span class="md-ellipsis">
  450. Featured Media and Publicity
  451. </span>
  452. </a>
  453. </li>
  454. <li class="md-nav__item">
  455. <a href="pages/wiki/limit_drive_spinup/" class="md-nav__link">
  456. <span class="md-ellipsis">
  457. Limit drive spinup
  458. </span>
  459. </a>
  460. </li>
  461. <li class="md-nav__item">
  462. <a href="pages/wiki/links/" class="md-nav__link">
  463. <span class="md-ellipsis">
  464. Links
  465. </span>
  466. </a>
  467. </li>
  468. </ul>
  469. </nav>
  470. </li>
  471. </ul>
  472. </nav>
  473. </div>
  474. </div>
  475. </div>
  476. <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
  477. <div class="md-sidebar__scrollwrap">
  478. <div class="md-sidebar__inner">
  479. <nav class="md-nav md-nav--secondary" aria-label="Table of contents">
  480. <label class="md-nav__title" for="__toc">
  481. <span class="md-nav__icon md-icon"></span>
  482. Table of contents
  483. </label>
  484. <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
  485. <li class="md-nav__item">
  486. <a href="#description" class="md-nav__link">
  487. <span class="md-ellipsis">
  488. DESCRIPTION
  489. </span>
  490. </a>
  491. </li>
  492. <li class="md-nav__item">
  493. <a href="#features" class="md-nav__link">
  494. <span class="md-ellipsis">
  495. FEATURES
  496. </span>
  497. </a>
  498. </li>
  499. <li class="md-nav__item">
  500. <a href="#synopsis" class="md-nav__link">
  501. <span class="md-ellipsis">
  502. SYNOPSIS
  503. </span>
  504. </a>
  505. </li>
  506. <li class="md-nav__item">
  507. <a href="#documentation" class="md-nav__link">
  508. <span class="md-ellipsis">
  509. DOCUMENTATION
  510. </span>
  511. </a>
  512. </li>
  513. <li class="md-nav__item">
  514. <a href="#tools" class="md-nav__link">
  515. <span class="md-ellipsis">
  516. TOOLS
  517. </span>
  518. </a>
  519. </li>
  520. </ul>
  521. </nav>
  522. </div>
  523. </div>
  524. </div>
  525. <div class="md-content" data-md-component="content">
  526. <article class="md-content__inner md-typeset">
  527. <a href="https://github.com/trapexit/mergerfs/tree/master/mkdocs/docs/index.md" title="Edit this page" class="md-content__button md-icon">
  528. <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>
  529. </a>
  530. <h1 id="mergerfs-a-featureful-union-filesystem">mergerfs - a featureful union filesystem</h1>
  531. <h2 id="description">DESCRIPTION</h2>
  532. <p><strong>mergerfs</strong> is a union filesystem geared towards simplifying storage
  533. and management of files across numerous commodity storage devices. It
  534. is similar to <strong>mhddfs</strong>, <strong>unionfs</strong>, and <strong>aufs</strong>.</p>
  535. <h2 id="features">FEATURES</h2>
  536. <ul>
  537. <li>Configurable behaviors / file placement</li>
  538. <li>Ability to add or remove filesystems at will</li>
  539. <li>Resistance to individual filesystem failure</li>
  540. <li>Support for extended attributes (xattrs)</li>
  541. <li>Support for file attributes (chattr)</li>
  542. <li>Runtime configurable (via xattrs)</li>
  543. <li>Works with heterogeneous filesystem types</li>
  544. <li>Moving of file when filesystem runs out of space while writing</li>
  545. <li>Ignore read-only filesystems when creating files</li>
  546. <li>Turn read-only files into symlinks to underlying file</li>
  547. <li>Hard link copy-on-write / CoW</li>
  548. <li>Support for POSIX ACLs</li>
  549. <li>Misc other things</li>
  550. </ul>
  551. <h2 id="synopsis">SYNOPSIS</h2>
  552. <p>mergerfs -o&lt;options&gt; &lt;branches&gt; &lt;mountpoint&gt;</p>
  553. <h2 id="documentation">DOCUMENTATION</h2>
  554. <ul>
  555. <li><a href="https://trapexit.github.io/mergerfs/">https://trapexit.github.io/mergerfs/</a></li>
  556. </ul>
  557. <h2 id="tools">TOOLS</h2>
  558. <ul>
  559. <li><a href="https://github.com/trapexit/mergerfs-tools">mergerfs tools</a></li>
  560. </ul>
  561. </article>
  562. </div>
  563. <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
  564. </div>
  565. </main>
  566. <footer class="md-footer">
  567. <div class="md-footer-meta md-typeset">
  568. <div class="md-footer-meta__inner md-grid">
  569. <div class="md-copyright">
  570. Made with
  571. <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
  572. Material for MkDocs
  573. </a>
  574. </div>
  575. </div>
  576. </div>
  577. </footer>
  578. </div>
  579. <div class="md-dialog" data-md-component="dialog">
  580. <div class="md-dialog__inner md-typeset"></div>
  581. </div>
  582. <script id="__config" type="application/json">{"base": ".", "features": ["content.action.edit"], "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>
  583. <script src="assets/javascripts/bundle.88dd0f4e.min.js"></script>
  584. </body>
  585. </html>