{"code":"var Component=(()=>{var k=Object.create;var r=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var g=Object.getOwnPropertyNames;var u=Object.getPrototypeOf,m=Object.prototype.hasOwnProperty;var y=(n,e)=>()=>(e||n((e={exports:{}}).exports,e),e.exports),f=(n,e)=>{for(var s in e)r(n,s,{get:e[s],enumerable:!0})},t=(n,e,s,h)=>{if(e&&typeof e==\"object\"||typeof e==\"function\")for(let l of g(e))!m.call(n,l)&&l!==s&&r(n,l,{get:()=>e[l],enumerable:!(h=p(e,l))||h.enumerable});return n};var b=(n,e,s)=>(s=n!=null?k(u(n)):{},t(e||!n||!n.__esModule?r(s,\"default\",{value:n,enumerable:!0}):s,n)),F=n=>t(r({},\"__esModule\",{value:!0}),n);var c=y((v,a)=>{a.exports=_jsx_runtime});var S={};f(S,{default:()=>o});var i=b(c());function d(n){let e={a:\"a\",code:\"code\",em:\"em\",h2:\"h2\",h3:\"h3\",hr:\"hr\",img:\"img\",input:\"input\",li:\"li\",ol:\"ol\",p:\"p\",pre:\"pre\",span:\"span\",strong:\"strong\",table:\"table\",tbody:\"tbody\",td:\"td\",th:\"th\",thead:\"thead\",tr:\"tr\",ul:\"ul\",...n.components};return(0,i.jsxs)(i.Fragment,{children:[(0,i.jsx)(e.p,{children:\"macOS Tahoe 26.2 has introduced significant changes to SMB (Server Message Block) protocol handling that have caused widespread connectivity issues with network drives and NAS (Network Attached Storage) devices. This comprehensive troubleshooting guide provides tested solutions for Synology, QNAP, TrueNAS, and other NAS systems, helping you restore reliable network storage access on your Mac.\"}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.img,{alt:\"NAS Network Storage Setup\",src:\"/images/blog/macos-tahoe-smb-network-drive-nas-troubleshooting-guide-2025/hero-server-rack-closeup.jpg\",width:\"1920\",height:\"1077\"})}),`\n`,(0,i.jsx)(e.h2,{id:\"executive-summary-smb-connectivity-crisis-in-macos-tahoe\",children:\"Executive Summary: SMB Connectivity Crisis in macOS Tahoe\"}),`\n`,(0,i.jsx)(e.h3,{id:\"the-scale-of-the-problem\",children:\"The Scale of the Problem\"}),`\n`,(0,i.jsx)(e.p,{children:\"Since macOS Tahoe's release in September 2025, SMB network drive connectivity has become one of the most reported issues affecting Mac users, particularly those in business environments and home office setups with NAS devices. The problems have persisted through versions 26.0, 26.1, and 26.2, indicating fundamental changes in how macOS handles SMB connections.\"}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"Key Issues Reported by Users:\"})}),`\n`,(0,i.jsxs)(e.ul,{children:[`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"Auto-mount Failures\"}),\": Network drives no longer automatically connect on restart or wake from sleep\"]}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"Authentication Loops\"}),\": Constant credential prompts despite saving passwords to Keychain\"]}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"Connection Drops\"}),\": SMB shares disconnecting during file transfers or after idle periods\"]}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"Time Machine Failures\"}),': Backup operations failing with \"BACKUP_FAILED_DISCONNECTED_DISK_IMAGE\" errors']}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"Access Denied Errors\"}),\": Previously working connections suddenly requiring re-authentication\"]}),`\n`]}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"Affected NAS Systems:\"})}),`\n`,(0,i.jsxs)(e.table,{children:[(0,i.jsx)(e.thead,{children:(0,i.jsxs)(e.tr,{children:[(0,i.jsx)(e.th,{children:\"Manufacturer\"}),(0,i.jsx)(e.th,{children:\"Models Affected\"}),(0,i.jsx)(e.th,{children:\"Severity\"})]})}),(0,i.jsxs)(e.tbody,{children:[(0,i.jsxs)(e.tr,{children:[(0,i.jsx)(e.td,{children:\"Synology\"}),(0,i.jsx)(e.td,{children:\"DS224+, DS923+, DS1522+, RS1221+\"}),(0,i.jsx)(e.td,{children:\"High\"})]}),(0,i.jsxs)(e.tr,{children:[(0,i.jsx)(e.td,{children:\"QNAP\"}),(0,i.jsx)(e.td,{children:\"TS-464, TS-653D, TS-873A, TVS-h674\"}),(0,i.jsx)(e.td,{children:\"High\"})]}),(0,i.jsxs)(e.tr,{children:[(0,i.jsx)(e.td,{children:\"TrueNAS\"}),(0,i.jsx)(e.td,{children:\"CORE, SCALE (all versions)\"}),(0,i.jsx)(e.td,{children:\"Medium\"})]}),(0,i.jsxs)(e.tr,{children:[(0,i.jsx)(e.td,{children:\"Unraid\"}),(0,i.jsx)(e.td,{children:\"All versions\"}),(0,i.jsx)(e.td,{children:\"Medium\"})]}),(0,i.jsxs)(e.tr,{children:[(0,i.jsx)(e.td,{children:\"Western Digital\"}),(0,i.jsx)(e.td,{children:\"My Cloud series\"}),(0,i.jsx)(e.td,{children:\"High\"})]}),(0,i.jsxs)(e.tr,{children:[(0,i.jsx)(e.td,{children:\"Asustor\"}),(0,i.jsx)(e.td,{children:\"AS5304T, AS6604T\"}),(0,i.jsx)(e.td,{children:\"Medium\"})]})]})]}),`\n`,(0,i.jsx)(e.h3,{id:\"root-cause-analysis\",children:\"Root Cause Analysis\"}),`\n`,(0,i.jsx)(e.p,{children:\"Apple's macOS Tahoe changed several default SMB behaviors that conflict with many NAS devices:\"}),`\n`,(0,i.jsxs)(e.ol,{children:[`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"Stricter SMB Signing Requirements\"}),\": Tahoe now defaults to \",(0,i.jsx)(e.code,{children:\"signing_required=yes\"}),\", breaking connections with NAS devices configured for relaxed SMB settings\"]}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"Enhanced Encryption Negotiation\"}),\": New encryption requirements may exceed capabilities of older NAS firmware\"]}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"Directory Caching Changes\"}),\": Modified caching behavior causes stale file listings and connection issues\"]}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"Credential Handling\"}),\": Changes to Keychain integration affect password storage for network shares\"]}),`\n`]}),`\n`,(0,i.jsx)(e.hr,{}),`\n`,(0,i.jsx)(e.h2,{id:\"quick-diagnostic-identify-your-specific-problem\",children:\"Quick Diagnostic: Identify Your Specific Problem\"}),`\n`,(0,i.jsx)(e.p,{children:\"Before diving into solutions, identify which issue category matches your symptoms:\"}),`\n`,(0,i.jsx)(e.h3,{id:\"category-a-cannot-connect-at-all\",children:\"Category A: Cannot Connect at All\"}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"Symptoms:\"})}),`\n`,(0,i.jsxs)(e.ul,{children:[`\n`,(0,i.jsx)(e.li,{children:'\"Connection Failed\" error when attempting to mount share'}),`\n`,(0,i.jsx)(e.li,{children:`\"The operation couldn't be completed\" messages`}),`\n`,(0,i.jsx)(e.li,{children:\"NAS not visible in Finder Network locations\"}),`\n`]}),`\n`,(0,i.jsxs)(e.p,{children:[(0,i.jsx)(e.strong,{children:\"Primary Solutions:\"}),\" \",(0,i.jsx)(e.a,{href:\"#authentication-and-connection-fixes\",children:\"Authentication & Connection Fixes\"})]}),`\n`,(0,i.jsx)(e.h3,{id:\"category-b-connections-drop-unexpectedly\",children:\"Category B: Connections Drop Unexpectedly\"}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"Symptoms:\"})}),`\n`,(0,i.jsxs)(e.ul,{children:[`\n`,(0,i.jsx)(e.li,{children:\"Shares disconnect after Mac wakes from sleep\"}),`\n`,(0,i.jsx)(e.li,{children:\"File transfers interrupted mid-operation\"}),`\n`,(0,i.jsx)(e.li,{children:`\"The server 'X' may not exist\" errors appear randomly`}),`\n`]}),`\n`,(0,i.jsxs)(e.p,{children:[(0,i.jsx)(e.strong,{children:\"Primary Solutions:\"}),\" \",(0,i.jsx)(e.a,{href:\"#connection-stability-fixes\",children:\"Connection Stability Fixes\"})]}),`\n`,(0,i.jsx)(e.h3,{id:\"category-c-auto-mount-not-working\",children:\"Category C: Auto-Mount Not Working\"}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"Symptoms:\"})}),`\n`,(0,i.jsxs)(e.ul,{children:[`\n`,(0,i.jsx)(e.li,{children:\"Network drives don't reconnect on login\"}),`\n`,(0,i.jsx)(e.li,{children:\"Login Items configured but shares don't mount\"}),`\n`,(0,i.jsx)(e.li,{children:\"Manual connection required every time\"}),`\n`]}),`\n`,(0,i.jsxs)(e.p,{children:[(0,i.jsx)(e.strong,{children:\"Primary Solutions:\"}),\" \",(0,i.jsx)(e.a,{href:\"#auto-mount-configuration-fixes\",children:\"Auto-Mount Configuration\"})]}),`\n`,(0,i.jsx)(e.h3,{id:\"category-d-time-machine-backup-failures\",children:\"Category D: Time Machine Backup Failures\"}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"Symptoms:\"})}),`\n`,(0,i.jsxs)(e.ul,{children:[`\n`,(0,i.jsx)(e.li,{children:'Backups stuck at \"Preparing\" stage'}),`\n`,(0,i.jsx)(e.li,{children:\"BACKUP_FAILED_DISCONNECTED_DISK_IMAGE errors\"}),`\n`,(0,i.jsx)(e.li,{children:\"Verification failures on existing backups\"}),`\n`]}),`\n`,(0,i.jsxs)(e.p,{children:[(0,i.jsx)(e.strong,{children:\"Primary Solutions:\"}),\" \",(0,i.jsx)(e.a,{href:\"#time-machine-backup-fixes\",children:\"Time Machine Specific Fixes\"})]}),`\n`,(0,i.jsx)(e.hr,{}),`\n`,(0,i.jsx)(e.h2,{id:\"core-solution-configure-etcnsmbconf\",children:\"Core Solution: Configure /etc/nsmb.conf\"}),`\n`,(0,i.jsxs)(e.p,{children:[\"The most effective solution for macOS Tahoe SMB issues involves configuring the system's SMB client settings through the \",(0,i.jsx)(e.code,{children:\"/etc/nsmb.conf\"}),\" file. This file doesn't exist by default but can be created to override problematic defaults.\"]}),`\n`,(0,i.jsx)(e.h3,{id:\"step-by-step-configuration\",children:\"Step-by-Step Configuration\"}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"1. Open Terminal\"})}),`\n`,(0,i.jsx)(e.p,{children:'Launch Terminal from Applications > Utilities, or use Spotlight (Cmd + Space) and type \"Terminal\".'}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"2. Create the Configuration File\"})}),`\n`,(0,i.jsx)(i.Fragment,{children:(0,i.jsx)(e.pre,{className:\"shiki shiki-themes github-light github-dark\",style:{\"--shiki-light\":\"#24292e\",\"--shiki-dark\":\"#e1e4e8\",\"--shiki-light-bg\":\"#fff\",\"--shiki-dark-bg\":\"#24292e\"},tabIndex:\"0\",icon:'<svg viewBox=\"0 0 24 24\"><path d=\"m 4,4 a 1,1 0 0 0 -0.7070312,0.2929687 1,1 0 0 0 0,1.4140625 L 8.5859375,11 3.2929688,16.292969 a 1,1 0 0 0 0,1.414062 1,1 0 0 0 1.4140624,0 l 5.9999998,-6 a 1.0001,1.0001 0 0 0 0,-1.414062 L 4.7070312,4.2929687 A 1,1 0 0 0 4,4 Z m 8,14 a 1,1 0 0 0 -1,1 1,1 0 0 0 1,1 h 8 a 1,1 0 0 0 1,-1 1,1 0 0 0 -1,-1 z\" fill=\"currentColor\" /></svg>',children:(0,i.jsx)(e.code,{children:(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6F42C1\",\"--shiki-dark\":\"#B392F0\"},children:\"sudo\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" nano\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" /etc/nsmb.conf\"})]})})})}),`\n`,(0,i.jsx)(e.p,{children:\"Enter your administrator password when prompted.\"}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"3. Add the Recommended Configuration\"})}),`\n`,(0,i.jsx)(e.p,{children:\"Copy and paste the following configuration:\"}),`\n`,(0,i.jsx)(i.Fragment,{children:(0,i.jsx)(e.pre,{className:\"shiki shiki-themes github-light github-dark\",style:{\"--shiki-light\":\"#24292e\",\"--shiki-dark\":\"#e1e4e8\",\"--shiki-light-bg\":\"#fff\",\"--shiki-dark-bg\":\"#24292e\"},tabIndex:\"0\",icon:'<svg viewBox=\"0 0 24 24\"><path d=\"M 6,1 C 4.354992,1 3,2.354992 3,4 v 16 c 0,1.645008 1.354992,3 3,3 h 12 c 1.645008,0 3,-1.354992 3,-3 V 8 7 A 1.0001,1.0001 0 0 0 20.707031,6.2929687 l -5,-5 A 1.0001,1.0001 0 0 0 15,1 h -1 z m 0,2 h 7 v 3 c 0,1.645008 1.354992,3 3,3 h 3 v 11 c 0,0.564129 -0.435871,1 -1,1 H 6 C 5.4358712,21 5,20.564129 5,20 V 4 C 5,3.4358712 5.4358712,3 6,3 Z M 15,3.4140625 18.585937,7 H 16 C 15.435871,7 15,6.5641288 15,6 Z\" fill=\"currentColor\" /></svg>',children:(0,i.jsxs)(e.code,{children:[(0,i.jsx)(e.span,{className:\"line\",children:(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6F42C1\",\"--shiki-dark\":\"#B392F0\"},children:\"[default]\"})}),`\n`,(0,i.jsx)(e.span,{className:\"line\",children:(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6A737D\",\"--shiki-dark\":\"#6A737D\"},children:\"# SMB Protocol Settings\"})}),`\n`,(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#D73A49\",\"--shiki-dark\":\"#F97583\"},children:\"signing_required\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#24292E\",\"--shiki-dark\":\"#E1E4E8\"},children:\"=no\"})]}),`\n`,(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#D73A49\",\"--shiki-dark\":\"#F97583\"},children:\"validate_neg_off\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#24292E\",\"--shiki-dark\":\"#E1E4E8\"},children:\"=yes\"})]}),`\n`,(0,i.jsx)(e.span,{className:\"line\"}),`\n`,(0,i.jsx)(e.span,{className:\"line\",children:(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6A737D\",\"--shiki-dark\":\"#6A737D\"},children:\"# Connection Reliability\"})}),`\n`,(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#D73A49\",\"--shiki-dark\":\"#F97583\"},children:\"soft\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#24292E\",\"--shiki-dark\":\"#E1E4E8\"},children:\"=yes\"})]}),`\n`,(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#D73A49\",\"--shiki-dark\":\"#F97583\"},children:\"notify_off\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#24292E\",\"--shiki-dark\":\"#E1E4E8\"},children:\"=yes\"})]}),`\n`,(0,i.jsx)(e.span,{className:\"line\"}),`\n`,(0,i.jsx)(e.span,{className:\"line\",children:(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6A737D\",\"--shiki-dark\":\"#6A737D\"},children:\"# Caching Optimization\"})}),`\n`,(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#D73A49\",\"--shiki-dark\":\"#F97583\"},children:\"dir_cache_max_cnt\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#24292E\",\"--shiki-dark\":\"#E1E4E8\"},children:\"=0\"})]}),`\n`,(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#D73A49\",\"--shiki-dark\":\"#F97583\"},children:\"dir_cache_max\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#24292E\",\"--shiki-dark\":\"#E1E4E8\"},children:\"=0\"})]}),`\n`,(0,i.jsx)(e.span,{className:\"line\"}),`\n`,(0,i.jsx)(e.span,{className:\"line\",children:(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6A737D\",\"--shiki-dark\":\"#6A737D\"},children:\"# Protocol Version (6 = SMB 2/3 enabled, 4 = SMB 3 only)\"})}),`\n`,(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#D73A49\",\"--shiki-dark\":\"#F97583\"},children:\"protocol_vers_map\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#24292E\",\"--shiki-dark\":\"#E1E4E8\"},children:\"=6\"})]}),`\n`,(0,i.jsx)(e.span,{className:\"line\"}),`\n`,(0,i.jsx)(e.span,{className:\"line\",children:(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6A737D\",\"--shiki-dark\":\"#6A737D\"},children:\"# Multichannel Settings (disable if experiencing issues)\"})}),`\n`,(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#D73A49\",\"--shiki-dark\":\"#F97583\"},children:\"mc_on\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#24292E\",\"--shiki-dark\":\"#E1E4E8\"},children:\"=no\"})]}),`\n`,(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#D73A49\",\"--shiki-dark\":\"#F97583\"},children:\"mc_prefer_wired\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#24292E\",\"--shiki-dark\":\"#E1E4E8\"},children:\"=yes\"})]}),`\n`,(0,i.jsx)(e.span,{className:\"line\"}),`\n`,(0,i.jsx)(e.span,{className:\"line\",children:(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6A737D\",\"--shiki-dark\":\"#6A737D\"},children:\"# Stream Support\"})}),`\n`,(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#D73A49\",\"--shiki-dark\":\"#F97583\"},children:\"streams\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#24292E\",\"--shiki-dark\":\"#E1E4E8\"},children:\"=yes\"})]})]})})}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"4. Save and Exit\"})}),`\n`,(0,i.jsxs)(e.p,{children:[\"Press \",(0,i.jsx)(e.code,{children:\"Ctrl + O\"}),\" to save, then \",(0,i.jsx)(e.code,{children:\"Ctrl + X\"}),\" to exit nano.\"]}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"5. Apply Changes\"})}),`\n`,(0,i.jsx)(e.p,{children:\"Restart your Mac for the changes to take effect:\"}),`\n`,(0,i.jsx)(i.Fragment,{children:(0,i.jsx)(e.pre,{className:\"shiki shiki-themes github-light github-dark\",style:{\"--shiki-light\":\"#24292e\",\"--shiki-dark\":\"#e1e4e8\",\"--shiki-light-bg\":\"#fff\",\"--shiki-dark-bg\":\"#24292e\"},tabIndex:\"0\",icon:'<svg viewBox=\"0 0 24 24\"><path d=\"m 4,4 a 1,1 0 0 0 -0.7070312,0.2929687 1,1 0 0 0 0,1.4140625 L 8.5859375,11 3.2929688,16.292969 a 1,1 0 0 0 0,1.414062 1,1 0 0 0 1.4140624,0 l 5.9999998,-6 a 1.0001,1.0001 0 0 0 0,-1.414062 L 4.7070312,4.2929687 A 1,1 0 0 0 4,4 Z m 8,14 a 1,1 0 0 0 -1,1 1,1 0 0 0 1,1 h 8 a 1,1 0 0 0 1,-1 1,1 0 0 0 -1,-1 z\" fill=\"currentColor\" /></svg>',children:(0,i.jsx)(e.code,{children:(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6F42C1\",\"--shiki-dark\":\"#B392F0\"},children:\"sudo\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" reboot\"})]})})})}),`\n`,(0,i.jsx)(e.h3,{id:\"configuration-options-explained\",children:\"Configuration Options Explained\"}),`\n`,(0,i.jsxs)(e.table,{children:[(0,i.jsx)(e.thead,{children:(0,i.jsxs)(e.tr,{children:[(0,i.jsx)(e.th,{children:\"Setting\"}),(0,i.jsx)(e.th,{children:\"Value\"}),(0,i.jsx)(e.th,{children:\"Purpose\"})]})}),(0,i.jsxs)(e.tbody,{children:[(0,i.jsxs)(e.tr,{children:[(0,i.jsx)(e.td,{children:(0,i.jsx)(e.code,{children:\"signing_required\"})}),(0,i.jsx)(e.td,{children:\"no\"}),(0,i.jsx)(e.td,{children:\"Disables mandatory SMB signing for compatibility\"})]}),(0,i.jsxs)(e.tr,{children:[(0,i.jsx)(e.td,{children:(0,i.jsx)(e.code,{children:\"validate_neg_off\"})}),(0,i.jsx)(e.td,{children:\"yes\"}),(0,i.jsx)(e.td,{children:\"Skips signature validation during negotiation\"})]}),(0,i.jsxs)(e.tr,{children:[(0,i.jsx)(e.td,{children:(0,i.jsx)(e.code,{children:\"soft\"})}),(0,i.jsx)(e.td,{children:\"yes\"}),(0,i.jsx)(e.td,{children:\"Allows graceful timeout handling\"})]}),(0,i.jsxs)(e.tr,{children:[(0,i.jsx)(e.td,{children:(0,i.jsx)(e.code,{children:\"dir_cache_max_cnt\"})}),(0,i.jsx)(e.td,{children:\"0\"}),(0,i.jsx)(e.td,{children:\"Disables directory caching to ensure fresh listings\"})]}),(0,i.jsxs)(e.tr,{children:[(0,i.jsx)(e.td,{children:(0,i.jsx)(e.code,{children:\"protocol_vers_map\"})}),(0,i.jsx)(e.td,{children:\"6\"}),(0,i.jsx)(e.td,{children:\"Enables SMB 2 and 3 protocols\"})]}),(0,i.jsxs)(e.tr,{children:[(0,i.jsx)(e.td,{children:(0,i.jsx)(e.code,{children:\"mc_on\"})}),(0,i.jsx)(e.td,{children:\"no\"}),(0,i.jsx)(e.td,{children:\"Disables SMB Multichannel (common source of issues)\"})]})]})]}),`\n`,(0,i.jsx)(e.hr,{}),`\n`,(0,i.jsx)(e.h2,{id:\"authentication-and-connection-fixes\",children:\"Authentication and Connection Fixes\"}),`\n`,(0,i.jsx)(e.h3,{id:\"fix-1-reset-keychain-entries-for-network-shares\",children:\"Fix 1: Reset Keychain Entries for Network Shares\"}),`\n`,(0,i.jsx)(e.p,{children:\"Corrupted Keychain entries often cause authentication loops in macOS Tahoe.\"}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"Steps:\"})}),`\n`,(0,i.jsxs)(e.ol,{children:[`\n`,(0,i.jsxs)(e.li,{children:[\"Open \",(0,i.jsx)(e.strong,{children:\"Keychain Access\"}),\" (Applications > Utilities)\"]}),`\n`,(0,i.jsx)(e.li,{children:\"Search for your NAS hostname or IP address\"}),`\n`,(0,i.jsx)(e.li,{children:\"Delete all related entries (passwords, certificates)\"}),`\n`,(0,i.jsx)(e.li,{children:\"Reconnect to your NAS and save new credentials\"}),`\n`]}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.img,{alt:\"Finder Connect to Server\",src:\"/images/blog/macos-tahoe-smb-network-drive-nas-troubleshooting-guide-2025/finder-connect-to-server.png\",width:\"480\",height:\"472\"})}),`\n`,(0,i.jsx)(e.h3,{id:\"fix-2-use-ip-address-instead-of-hostname\",children:\"Fix 2: Use IP Address Instead of Hostname\"}),`\n`,(0,i.jsx)(e.p,{children:\"DNS resolution issues can prevent connections in Tahoe. Using the direct IP address often resolves this.\"}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"Instead of:\"})}),`\n`,(0,i.jsx)(i.Fragment,{children:(0,i.jsx)(e.pre,{className:\"shiki shiki-themes github-light github-dark\",style:{\"--shiki-light\":\"#24292e\",\"--shiki-dark\":\"#e1e4e8\",\"--shiki-light-bg\":\"#fff\",\"--shiki-dark-bg\":\"#24292e\"},tabIndex:\"0\",icon:'<svg viewBox=\"0 0 24 24\"><path d=\"M 6,1 C 4.354992,1 3,2.354992 3,4 v 16 c 0,1.645008 1.354992,3 3,3 h 12 c 1.645008,0 3,-1.354992 3,-3 V 8 7 A 1.0001,1.0001 0 0 0 20.707031,6.2929687 l -5,-5 A 1.0001,1.0001 0 0 0 15,1 h -1 z m 0,2 h 7 v 3 c 0,1.645008 1.354992,3 3,3 h 3 v 11 c 0,0.564129 -0.435871,1 -1,1 H 6 C 5.4358712,21 5,20.564129 5,20 V 4 C 5,3.4358712 5.4358712,3 6,3 Z M 15,3.4140625 18.585937,7 H 16 C 15.435871,7 15,6.5641288 15,6 Z\" fill=\"currentColor\" /></svg>',children:(0,i.jsx)(e.code,{children:(0,i.jsx)(e.span,{className:\"line\",children:(0,i.jsx)(e.span,{children:\"smb://synology-nas.local/share\"})})})})}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"Use:\"})}),`\n`,(0,i.jsx)(i.Fragment,{children:(0,i.jsx)(e.pre,{className:\"shiki shiki-themes github-light github-dark\",style:{\"--shiki-light\":\"#24292e\",\"--shiki-dark\":\"#e1e4e8\",\"--shiki-light-bg\":\"#fff\",\"--shiki-dark-bg\":\"#24292e\"},tabIndex:\"0\",icon:'<svg viewBox=\"0 0 24 24\"><path d=\"M 6,1 C 4.354992,1 3,2.354992 3,4 v 16 c 0,1.645008 1.354992,3 3,3 h 12 c 1.645008,0 3,-1.354992 3,-3 V 8 7 A 1.0001,1.0001 0 0 0 20.707031,6.2929687 l -5,-5 A 1.0001,1.0001 0 0 0 15,1 h -1 z m 0,2 h 7 v 3 c 0,1.645008 1.354992,3 3,3 h 3 v 11 c 0,0.564129 -0.435871,1 -1,1 H 6 C 5.4358712,21 5,20.564129 5,20 V 4 C 5,3.4358712 5.4358712,3 6,3 Z M 15,3.4140625 18.585937,7 H 16 C 15.435871,7 15,6.5641288 15,6 Z\" fill=\"currentColor\" /></svg>',children:(0,i.jsx)(e.code,{children:(0,i.jsx)(e.span,{className:\"line\",children:(0,i.jsx)(e.span,{children:\"smb://192.168.1.100/share\"})})})})}),`\n`,(0,i.jsx)(e.h3,{id:\"fix-3-verify-smb-protocol-version-on-nas\",children:\"Fix 3: Verify SMB Protocol Version on NAS\"}),`\n`,(0,i.jsx)(e.p,{children:\"Ensure your NAS is configured to use SMB 3 protocol:\"}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"For Synology:\"})}),`\n`,(0,i.jsxs)(e.ol,{children:[`\n`,(0,i.jsx)(e.li,{children:\"Open DSM Control Panel\"}),`\n`,(0,i.jsx)(e.li,{children:\"Navigate to File Services > SMB\"}),`\n`,(0,i.jsx)(e.li,{children:\"Set Maximum SMB Protocol to SMB3\"}),`\n`,(0,i.jsx)(e.li,{children:'Enable \"Enable SMB2 minimum protocol\" if available'}),`\n`]}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.img,{alt:\"Synology SMB Enable Settings\",src:\"/images/blog/macos-tahoe-smb-network-drive-nas-troubleshooting-guide-2025/synology-smb-enable.png\",width:\"800\",height:\"475\"})}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"For QNAP:\"})}),`\n`,(0,i.jsxs)(e.ol,{children:[`\n`,(0,i.jsx)(e.li,{children:\"Open QTS Control Panel\"}),`\n`,(0,i.jsx)(e.li,{children:\"Go to Network & File Services > Win/Mac/NFS/WebDAV\"}),`\n`,(0,i.jsx)(e.li,{children:\"Click Advanced Options under Microsoft Networking\"}),`\n`,(0,i.jsx)(e.li,{children:\"Set Highest SMB version to SMB3\"}),`\n`]}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.img,{alt:\"QNAP SMB Settings\",src:\"/images/blog/macos-tahoe-smb-network-drive-nas-troubleshooting-guide-2025/qnap-smb-settings.png\",width:\"800\",height:\"475\"})}),`\n`,(0,i.jsx)(e.h3,{id:\"fix-4-flush-dns-cache\",children:\"Fix 4: Flush DNS Cache\"}),`\n`,(0,i.jsx)(e.p,{children:\"Stale DNS entries can cause connection failures:\"}),`\n`,(0,i.jsx)(i.Fragment,{children:(0,i.jsx)(e.pre,{className:\"shiki shiki-themes github-light github-dark\",style:{\"--shiki-light\":\"#24292e\",\"--shiki-dark\":\"#e1e4e8\",\"--shiki-light-bg\":\"#fff\",\"--shiki-dark-bg\":\"#24292e\"},tabIndex:\"0\",icon:'<svg viewBox=\"0 0 24 24\"><path d=\"m 4,4 a 1,1 0 0 0 -0.7070312,0.2929687 1,1 0 0 0 0,1.4140625 L 8.5859375,11 3.2929688,16.292969 a 1,1 0 0 0 0,1.414062 1,1 0 0 0 1.4140624,0 l 5.9999998,-6 a 1.0001,1.0001 0 0 0 0,-1.414062 L 4.7070312,4.2929687 A 1,1 0 0 0 4,4 Z m 8,14 a 1,1 0 0 0 -1,1 1,1 0 0 0 1,1 h 8 a 1,1 0 0 0 1,-1 1,1 0 0 0 -1,-1 z\" fill=\"currentColor\" /></svg>',children:(0,i.jsxs)(e.code,{children:[(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6F42C1\",\"--shiki-dark\":\"#B392F0\"},children:\"sudo\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" dscacheutil\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#005CC5\",\"--shiki-dark\":\"#79B8FF\"},children:\" -flushcache\"})]}),`\n`,(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6F42C1\",\"--shiki-dark\":\"#B392F0\"},children:\"sudo\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" killall\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#005CC5\",\"--shiki-dark\":\"#79B8FF\"},children:\" -HUP\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" mDNSResponder\"})]})]})})}),`\n`,(0,i.jsx)(e.hr,{}),`\n`,(0,i.jsx)(e.h2,{id:\"connection-stability-fixes\",children:\"Connection Stability Fixes\"}),`\n`,(0,i.jsx)(e.h3,{id:\"fix-5-disable-smb-multichannel\",children:\"Fix 5: Disable SMB Multichannel\"}),`\n`,(0,i.jsx)(e.p,{children:\"SMB Multichannel, while designed to improve performance, often causes stability issues with consumer NAS devices.\"}),`\n`,(0,i.jsxs)(e.p,{children:[\"Add to \",(0,i.jsx)(e.code,{children:\"/etc/nsmb.conf\"}),\":\"]}),`\n`,(0,i.jsx)(i.Fragment,{children:(0,i.jsx)(e.pre,{className:\"shiki shiki-themes github-light github-dark\",style:{\"--shiki-light\":\"#24292e\",\"--shiki-dark\":\"#e1e4e8\",\"--shiki-light-bg\":\"#fff\",\"--shiki-dark-bg\":\"#24292e\"},tabIndex:\"0\",icon:'<svg viewBox=\"0 0 24 24\"><path d=\"M 6,1 C 4.354992,1 3,2.354992 3,4 v 16 c 0,1.645008 1.354992,3 3,3 h 12 c 1.645008,0 3,-1.354992 3,-3 V 8 7 A 1.0001,1.0001 0 0 0 20.707031,6.2929687 l -5,-5 A 1.0001,1.0001 0 0 0 15,1 h -1 z m 0,2 h 7 v 3 c 0,1.645008 1.354992,3 3,3 h 3 v 11 c 0,0.564129 -0.435871,1 -1,1 H 6 C 5.4358712,21 5,20.564129 5,20 V 4 C 5,3.4358712 5.4358712,3 6,3 Z M 15,3.4140625 18.585937,7 H 16 C 15.435871,7 15,6.5641288 15,6 Z\" fill=\"currentColor\" /></svg>',children:(0,i.jsxs)(e.code,{children:[(0,i.jsx)(e.span,{className:\"line\",children:(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6F42C1\",\"--shiki-dark\":\"#B392F0\"},children:\"[default]\"})}),`\n`,(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#D73A49\",\"--shiki-dark\":\"#F97583\"},children:\"mc_on\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#24292E\",\"--shiki-dark\":\"#E1E4E8\"},children:\"=no\"})]}),`\n`,(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#D73A49\",\"--shiki-dark\":\"#F97583\"},children:\"mc_prefer_wired\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#24292E\",\"--shiki-dark\":\"#E1E4E8\"},children:\"=yes\"})]})]})})}),`\n`,(0,i.jsx)(e.h3,{id:\"fix-6-adjust-tcp-keepalive-settings\",children:\"Fix 6: Adjust TCP KeepAlive Settings\"}),`\n`,(0,i.jsx)(e.p,{children:\"Prevent connections from timing out during idle periods:\"}),`\n`,(0,i.jsx)(i.Fragment,{children:(0,i.jsx)(e.pre,{className:\"shiki shiki-themes github-light github-dark\",style:{\"--shiki-light\":\"#24292e\",\"--shiki-dark\":\"#e1e4e8\",\"--shiki-light-bg\":\"#fff\",\"--shiki-dark-bg\":\"#24292e\"},tabIndex:\"0\",icon:'<svg viewBox=\"0 0 24 24\"><path d=\"m 4,4 a 1,1 0 0 0 -0.7070312,0.2929687 1,1 0 0 0 0,1.4140625 L 8.5859375,11 3.2929688,16.292969 a 1,1 0 0 0 0,1.414062 1,1 0 0 0 1.4140624,0 l 5.9999998,-6 a 1.0001,1.0001 0 0 0 0,-1.414062 L 4.7070312,4.2929687 A 1,1 0 0 0 4,4 Z m 8,14 a 1,1 0 0 0 -1,1 1,1 0 0 0 1,1 h 8 a 1,1 0 0 0 1,-1 1,1 0 0 0 -1,-1 z\" fill=\"currentColor\" /></svg>',children:(0,i.jsxs)(e.code,{children:[(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6F42C1\",\"--shiki-dark\":\"#B392F0\"},children:\"sudo\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" sysctl\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#005CC5\",\"--shiki-dark\":\"#79B8FF\"},children:\" -w\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" net.inet.tcp.keepidle=\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#005CC5\",\"--shiki-dark\":\"#79B8FF\"},children:\"10000\"})]}),`\n`,(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6F42C1\",\"--shiki-dark\":\"#B392F0\"},children:\"sudo\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" sysctl\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#005CC5\",\"--shiki-dark\":\"#79B8FF\"},children:\" -w\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" net.inet.tcp.keepintvl=\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#005CC5\",\"--shiki-dark\":\"#79B8FF\"},children:\"5000\"})]}),`\n`,(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6F42C1\",\"--shiki-dark\":\"#B392F0\"},children:\"sudo\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" sysctl\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#005CC5\",\"--shiki-dark\":\"#79B8FF\"},children:\" -w\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" net.inet.tcp.keepcnt=\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#005CC5\",\"--shiki-dark\":\"#79B8FF\"},children:\"10\"})]})]})})}),`\n`,(0,i.jsxs)(e.p,{children:[\"To make these settings persistent, add to \",(0,i.jsx)(e.code,{children:\"/etc/sysctl.conf\"}),\":\"]}),`\n`,(0,i.jsx)(i.Fragment,{children:(0,i.jsx)(e.pre,{className:\"shiki shiki-themes github-light github-dark\",style:{\"--shiki-light\":\"#24292e\",\"--shiki-dark\":\"#e1e4e8\",\"--shiki-light-bg\":\"#fff\",\"--shiki-dark-bg\":\"#24292e\"},tabIndex:\"0\",icon:'<svg viewBox=\"0 0 24 24\"><path d=\"M 6,1 C 4.354992,1 3,2.354992 3,4 v 16 c 0,1.645008 1.354992,3 3,3 h 12 c 1.645008,0 3,-1.354992 3,-3 V 8 7 A 1.0001,1.0001 0 0 0 20.707031,6.2929687 l -5,-5 A 1.0001,1.0001 0 0 0 15,1 h -1 z m 0,2 h 7 v 3 c 0,1.645008 1.354992,3 3,3 h 3 v 11 c 0,0.564129 -0.435871,1 -1,1 H 6 C 5.4358712,21 5,20.564129 5,20 V 4 C 5,3.4358712 5.4358712,3 6,3 Z M 15,3.4140625 18.585937,7 H 16 C 15.435871,7 15,6.5641288 15,6 Z\" fill=\"currentColor\" /></svg>',children:(0,i.jsxs)(e.code,{children:[(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#D73A49\",\"--shiki-dark\":\"#F97583\"},children:\"net.inet.tcp.keepidle\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#24292E\",\"--shiki-dark\":\"#E1E4E8\"},children:\"=10000\"})]}),`\n`,(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#D73A49\",\"--shiki-dark\":\"#F97583\"},children:\"net.inet.tcp.keepintvl\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#24292E\",\"--shiki-dark\":\"#E1E4E8\"},children:\"=5000\"})]}),`\n`,(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#D73A49\",\"--shiki-dark\":\"#F97583\"},children:\"net.inet.tcp.keepcnt\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#24292E\",\"--shiki-dark\":\"#E1E4E8\"},children:\"=10\"})]})]})})}),`\n`,(0,i.jsx)(e.h3,{id:\"fix-7-disable-power-nap-for-network-operations\",children:\"Fix 7: Disable Power Nap for Network Operations\"}),`\n`,(0,i.jsx)(e.p,{children:\"Power Nap can disconnect SMB shares during sleep:\"}),`\n`,(0,i.jsxs)(e.ol,{children:[`\n`,(0,i.jsx)(e.li,{children:\"Open System Settings > Battery\"}),`\n`,(0,i.jsx)(e.li,{children:\"Click Options\"}),`\n`,(0,i.jsx)(e.li,{children:'Disable \"Wake for network access\" or adjust Power Nap settings'}),`\n`]}),`\n`,(0,i.jsx)(e.h3,{id:\"fix-8-use-wired-connection-when-possible\",children:\"Fix 8: Use Wired Connection When Possible\"}),`\n`,(0,i.jsx)(e.p,{children:\"Wi-Fi variability contributes to SMB instability. If experiencing frequent disconnections:\"}),`\n`,(0,i.jsxs)(e.ul,{children:[`\n`,(0,i.jsx)(e.li,{children:\"Connect Mac directly to router via Ethernet\"}),`\n`,(0,i.jsx)(e.li,{children:\"Use a Thunderbolt to Ethernet adapter for MacBooks without ports\"}),`\n`,(0,i.jsx)(e.li,{children:\"Configure your NAS for jumbo frames if both devices support it\"}),`\n`]}),`\n`,(0,i.jsx)(e.hr,{}),`\n`,(0,i.jsx)(e.h2,{id:\"auto-mount-configuration-fixes\",children:\"Auto-Mount Configuration Fixes\"}),`\n`,(0,i.jsx)(e.h3,{id:\"fix-9-create-custom-mount-points\",children:\"Fix 9: Create Custom Mount Points\"}),`\n`,(0,i.jsxs)(e.p,{children:[\"macOS Tahoe has issues with the default \",(0,i.jsx)(e.code,{children:\"/Volumes\"}),\" mount point. Creating a custom mount location in your home directory often resolves auto-mount failures.\"]}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"Step 1: Create a hidden mount directory\"})}),`\n`,(0,i.jsx)(i.Fragment,{children:(0,i.jsx)(e.pre,{className:\"shiki shiki-themes github-light github-dark\",style:{\"--shiki-light\":\"#24292e\",\"--shiki-dark\":\"#e1e4e8\",\"--shiki-light-bg\":\"#fff\",\"--shiki-dark-bg\":\"#24292e\"},tabIndex:\"0\",icon:'<svg viewBox=\"0 0 24 24\"><path d=\"m 4,4 a 1,1 0 0 0 -0.7070312,0.2929687 1,1 0 0 0 0,1.4140625 L 8.5859375,11 3.2929688,16.292969 a 1,1 0 0 0 0,1.414062 1,1 0 0 0 1.4140624,0 l 5.9999998,-6 a 1.0001,1.0001 0 0 0 0,-1.414062 L 4.7070312,4.2929687 A 1,1 0 0 0 4,4 Z m 8,14 a 1,1 0 0 0 -1,1 1,1 0 0 0 1,1 h 8 a 1,1 0 0 0 1,-1 1,1 0 0 0 -1,-1 z\" fill=\"currentColor\" /></svg>',children:(0,i.jsx)(e.code,{children:(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6F42C1\",\"--shiki-dark\":\"#B392F0\"},children:\"mkdir\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#005CC5\",\"--shiki-dark\":\"#79B8FF\"},children:\" -p\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" ~/.nas_mounts\"})]})})})}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"Step 2: Mount the share to the custom location\"})}),`\n`,(0,i.jsx)(i.Fragment,{children:(0,i.jsx)(e.pre,{className:\"shiki shiki-themes github-light github-dark\",style:{\"--shiki-light\":\"#24292e\",\"--shiki-dark\":\"#e1e4e8\",\"--shiki-light-bg\":\"#fff\",\"--shiki-dark-bg\":\"#24292e\"},tabIndex:\"0\",icon:'<svg viewBox=\"0 0 24 24\"><path d=\"m 4,4 a 1,1 0 0 0 -0.7070312,0.2929687 1,1 0 0 0 0,1.4140625 L 8.5859375,11 3.2929688,16.292969 a 1,1 0 0 0 0,1.414062 1,1 0 0 0 1.4140624,0 l 5.9999998,-6 a 1.0001,1.0001 0 0 0 0,-1.414062 L 4.7070312,4.2929687 A 1,1 0 0 0 4,4 Z m 8,14 a 1,1 0 0 0 -1,1 1,1 0 0 0 1,1 h 8 a 1,1 0 0 0 1,-1 1,1 0 0 0 -1,-1 z\" fill=\"currentColor\" /></svg>',children:(0,i.jsx)(e.code,{children:(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6F42C1\",\"--shiki-dark\":\"#B392F0\"},children:\"mount_smbfs\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" //username:password@192.168.1.100/share\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" ~/.nas_mounts/share\"})]})})})}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"Step 3: Add to Finder Sidebar\"})}),`\n`,(0,i.jsx)(e.p,{children:\"Drag the mounted share from the custom location to Finder's sidebar under Favorites.\"}),`\n`,(0,i.jsx)(e.h3,{id:\"fix-10-configure-login-items-properly\",children:\"Fix 10: Configure Login Items Properly\"}),`\n`,(0,i.jsx)(e.p,{children:\"The traditional Login Items approach still works but requires specific configuration:\"}),`\n`,(0,i.jsxs)(e.ol,{children:[`\n`,(0,i.jsx)(e.li,{children:\"Open System Settings > General > Login Items\"}),`\n`,(0,i.jsx)(e.li,{children:'Click the \"+\" button'}),`\n`,(0,i.jsx)(e.li,{children:\"Navigate to your mounted network share\"}),`\n`,(0,i.jsx)(e.li,{children:\"Add the share to login items\"}),`\n`]}),`\n`,(0,i.jsxs)(e.p,{children:[(0,i.jsx)(e.strong,{children:\"Important:\"}),\" The share must be currently mounted when adding it to Login Items.\"]}),`\n`,(0,i.jsx)(e.h3,{id:\"fix-11-use-automator-for-reliable-auto-mount\",children:\"Fix 11: Use Automator for Reliable Auto-Mount\"}),`\n`,(0,i.jsx)(e.p,{children:\"Create a more robust auto-mount solution using Automator:\"}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"Step 1: Open Automator and create a new Application\"})}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:'Step 2: Add \"Run AppleScript\" action with this code:'})}),`\n`,(0,i.jsx)(i.Fragment,{children:(0,i.jsx)(e.pre,{className:\"shiki shiki-themes github-light github-dark\",style:{\"--shiki-light\":\"#24292e\",\"--shiki-dark\":\"#e1e4e8\",\"--shiki-light-bg\":\"#fff\",\"--shiki-dark-bg\":\"#24292e\"},tabIndex:\"0\",icon:'<svg viewBox=\"0 0 24 24\"><path d=\"M 6,1 C 4.354992,1 3,2.354992 3,4 v 16 c 0,1.645008 1.354992,3 3,3 h 12 c 1.645008,0 3,-1.354992 3,-3 V 8 7 A 1.0001,1.0001 0 0 0 20.707031,6.2929687 l -5,-5 A 1.0001,1.0001 0 0 0 15,1 h -1 z m 0,2 h 7 v 3 c 0,1.645008 1.354992,3 3,3 h 3 v 11 c 0,0.564129 -0.435871,1 -1,1 H 6 C 5.4358712,21 5,20.564129 5,20 V 4 C 5,3.4358712 5.4358712,3 6,3 Z M 15,3.4140625 18.585937,7 H 16 C 15.435871,7 15,6.5641288 15,6 Z\" fill=\"currentColor\" /></svg>',children:(0,i.jsxs)(e.code,{children:[(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#D73A49\",\"--shiki-dark\":\"#F97583\"},children:\"on\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6F42C1\",\"--shiki-dark\":\"#B392F0\"},children:\" run\"})]}),`\n`,(0,i.jsx)(e.span,{className:\"line\",children:(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#D73A49\",\"--shiki-dark\":\"#F97583\"},children:\"    try\"})}),`\n`,(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#D73A49\",\"--shiki-dark\":\"#F97583\"},children:\"        tell\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#005CC5\",\"--shiki-dark\":\"#79B8FF\"},children:\" application\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:' \"Finder\"'})]}),`\n`,(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#005CC5\",\"--shiki-dark\":\"#79B8FF\"},children:\"            mount volume\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:' \"smb://username:password@192.168.1.100/share\"'})]}),`\n`,(0,i.jsx)(e.span,{className:\"line\",children:(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#D73A49\",\"--shiki-dark\":\"#F97583\"},children:\"        end tell\"})}),`\n`,(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#D73A49\",\"--shiki-dark\":\"#F97583\"},children:\"    on error\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#24292E\",\"--shiki-dark\":\"#E1E4E8\"},children:\" errMsg\"})]}),`\n`,(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#24292E\",\"--shiki-dark\":\"#E1E4E8\"},children:\"        display notification \"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:'\"Failed to mount NAS: \"'}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#D73A49\",\"--shiki-dark\":\"#F97583\"},children:\" &\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#24292E\",\"--shiki-dark\":\"#E1E4E8\"},children:\" errMsg\"})]}),`\n`,(0,i.jsx)(e.span,{className:\"line\",children:(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#D73A49\",\"--shiki-dark\":\"#F97583\"},children:\"    end try\"})}),`\n`,(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#D73A49\",\"--shiki-dark\":\"#F97583\"},children:\"end\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#24292E\",\"--shiki-dark\":\"#E1E4E8\"},children:\" run\"})]})]})})}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"Step 3: Save the application and add it to Login Items\"})}),`\n`,(0,i.jsx)(e.h3,{id:\"fix-12-third-party-auto-mount-solutions\",children:\"Fix 12: Third-Party Auto-Mount Solutions\"}),`\n`,(0,i.jsx)(e.p,{children:\"Several third-party applications provide more reliable auto-mounting:\"}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"Automounter by PixelEspresso\"})}),`\n`,(0,i.jsxs)(e.ul,{children:[`\n`,(0,i.jsx)(e.li,{children:\"Automatically mounts shares when Mac wakes\"}),`\n`,(0,i.jsx)(e.li,{children:\"Monitors connection status\"}),`\n`,(0,i.jsx)(e.li,{children:\"Reconnects dropped shares automatically\"}),`\n`]}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"Mountain Duck\"})}),`\n`,(0,i.jsxs)(e.ul,{children:[`\n`,(0,i.jsx)(e.li,{children:\"Mounts cloud storage and network shares as local drives\"}),`\n`,(0,i.jsx)(e.li,{children:\"Background mounting with connection monitoring\"}),`\n`,(0,i.jsx)(e.li,{children:\"Supports SMB, SFTP, WebDAV, and cloud services\"}),`\n`]}),`\n`,(0,i.jsx)(e.hr,{}),`\n`,(0,i.jsx)(e.h2,{id:\"time-machine-backup-fixes\",children:\"Time Machine Backup Fixes\"}),`\n`,(0,i.jsx)(e.h3,{id:\"fix-13-configure-nsmbconf-for-time-machine\",children:\"Fix 13: Configure nsmb.conf for Time Machine\"}),`\n`,(0,i.jsx)(e.p,{children:\"Time Machine has specific requirements that may conflict with standard SMB settings.\"}),`\n`,(0,i.jsxs)(e.p,{children:[\"Create a server-specific configuration section in \",(0,i.jsx)(e.code,{children:\"/etc/nsmb.conf\"}),\":\"]}),`\n`,(0,i.jsx)(i.Fragment,{children:(0,i.jsx)(e.pre,{className:\"shiki shiki-themes github-light github-dark\",style:{\"--shiki-light\":\"#24292e\",\"--shiki-dark\":\"#e1e4e8\",\"--shiki-light-bg\":\"#fff\",\"--shiki-dark-bg\":\"#24292e\"},tabIndex:\"0\",icon:'<svg viewBox=\"0 0 24 24\"><path d=\"M 6,1 C 4.354992,1 3,2.354992 3,4 v 16 c 0,1.645008 1.354992,3 3,3 h 12 c 1.645008,0 3,-1.354992 3,-3 V 8 7 A 1.0001,1.0001 0 0 0 20.707031,6.2929687 l -5,-5 A 1.0001,1.0001 0 0 0 15,1 h -1 z m 0,2 h 7 v 3 c 0,1.645008 1.354992,3 3,3 h 3 v 11 c 0,0.564129 -0.435871,1 -1,1 H 6 C 5.4358712,21 5,20.564129 5,20 V 4 C 5,3.4358712 5.4358712,3 6,3 Z M 15,3.4140625 18.585937,7 H 16 C 15.435871,7 15,6.5641288 15,6 Z\" fill=\"currentColor\" /></svg>',children:(0,i.jsxs)(e.code,{children:[(0,i.jsx)(e.span,{className:\"line\",children:(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6F42C1\",\"--shiki-dark\":\"#B392F0\"},children:\"[NAS_IP_ADDRESS]\"})}),`\n`,(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#D73A49\",\"--shiki-dark\":\"#F97583\"},children:\"signing_required\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#24292E\",\"--shiki-dark\":\"#E1E4E8\"},children:\"=no\"})]}),`\n`,(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#D73A49\",\"--shiki-dark\":\"#F97583\"},children:\"streams\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#24292E\",\"--shiki-dark\":\"#E1E4E8\"},children:\"=yes\"})]}),`\n`,(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#D73A49\",\"--shiki-dark\":\"#F97583\"},children:\"soft\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#24292E\",\"--shiki-dark\":\"#E1E4E8\"},children:\"=yes\"})]}),`\n`,(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#D73A49\",\"--shiki-dark\":\"#F97583\"},children:\"dir_cache_max_cnt\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#24292E\",\"--shiki-dark\":\"#E1E4E8\"},children:\"=0\"})]}),`\n`,(0,i.jsx)(e.span,{className:\"line\"}),`\n`,(0,i.jsx)(e.span,{className:\"line\",children:(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6F42C1\",\"--shiki-dark\":\"#B392F0\"},children:\"[default]\"})}),`\n`,(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#D73A49\",\"--shiki-dark\":\"#F97583\"},children:\"signing_required\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#24292E\",\"--shiki-dark\":\"#E1E4E8\"},children:\"=no\"})]}),`\n`,(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#D73A49\",\"--shiki-dark\":\"#F97583\"},children:\"validate_neg_off\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#24292E\",\"--shiki-dark\":\"#E1E4E8\"},children:\"=yes\"})]})]})})}),`\n`,(0,i.jsxs)(e.p,{children:[\"Replace \",(0,i.jsx)(e.code,{children:\"NAS_IP_ADDRESS\"}),\" with your NAS's actual IP (e.g., \",(0,i.jsx)(e.code,{children:\"192.168.1.100\"}),\").\"]}),`\n`,(0,i.jsx)(e.h3,{id:\"fix-14-fix-apfs-container-names\",children:\"Fix 14: Fix APFS Container Names\"}),`\n`,(0,i.jsx)(e.p,{children:\"APFS volumes with special characters in their names cause Time Machine failures:\"}),`\n`,(0,i.jsxs)(e.ol,{children:[`\n`,(0,i.jsx)(e.li,{children:\"Open Disk Utility\"}),`\n`,(0,i.jsx)(e.li,{children:\"Select your Time Machine destination\"}),`\n`,(0,i.jsx)(e.li,{children:\"Rename to use only ASCII characters (letters, numbers, hyphens)\"}),`\n`,(0,i.jsx)(e.li,{children:'Example: Change \"Time Machine (Synology)\" to \"TimeMachine-Synology\"'}),`\n`]}),`\n`,(0,i.jsx)(e.h3,{id:\"fix-15-reset-time-machine-configuration\",children:\"Fix 15: Reset Time Machine Configuration\"}),`\n`,(0,i.jsx)(e.p,{children:\"For persistent backup failures, reset the Time Machine configuration:\"}),`\n`,(0,i.jsx)(i.Fragment,{children:(0,i.jsx)(e.pre,{className:\"shiki shiki-themes github-light github-dark\",style:{\"--shiki-light\":\"#24292e\",\"--shiki-dark\":\"#e1e4e8\",\"--shiki-light-bg\":\"#fff\",\"--shiki-dark-bg\":\"#24292e\"},tabIndex:\"0\",icon:'<svg viewBox=\"0 0 24 24\"><path d=\"m 4,4 a 1,1 0 0 0 -0.7070312,0.2929687 1,1 0 0 0 0,1.4140625 L 8.5859375,11 3.2929688,16.292969 a 1,1 0 0 0 0,1.414062 1,1 0 0 0 1.4140624,0 l 5.9999998,-6 a 1.0001,1.0001 0 0 0 0,-1.414062 L 4.7070312,4.2929687 A 1,1 0 0 0 4,4 Z m 8,14 a 1,1 0 0 0 -1,1 1,1 0 0 0 1,1 h 8 a 1,1 0 0 0 1,-1 1,1 0 0 0 -1,-1 z\" fill=\"currentColor\" /></svg>',children:(0,i.jsxs)(e.code,{children:[(0,i.jsx)(e.span,{className:\"line\",children:(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6A737D\",\"--shiki-dark\":\"#6A737D\"},children:\"# Remove Time Machine preferences\"})}),`\n`,(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6F42C1\",\"--shiki-dark\":\"#B392F0\"},children:\"sudo\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" rm\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" /Library/Preferences/com.apple.TimeMachine.plist\"})]}),`\n`,(0,i.jsx)(e.span,{className:\"line\"}),`\n`,(0,i.jsx)(e.span,{className:\"line\",children:(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6A737D\",\"--shiki-dark\":\"#6A737D\"},children:\"# Remove local snapshots (optional)\"})}),`\n`,(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6F42C1\",\"--shiki-dark\":\"#B392F0\"},children:\"tmutil\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" listlocalsnapshots\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" /\"})]}),`\n`,(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6F42C1\",\"--shiki-dark\":\"#B392F0\"},children:\"tmutil\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" deletelocalsnapshots\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#24292E\",\"--shiki-dark\":\"#E1E4E8\"},children:\" [snapshot_name]\"})]})]})})}),`\n`,(0,i.jsx)(e.p,{children:\"Then reconfigure Time Machine from System Settings.\"}),`\n`,(0,i.jsx)(e.h3,{id:\"fix-16-update-nas-firmware\",children:\"Fix 16: Update NAS Firmware\"}),`\n`,(0,i.jsx)(e.p,{children:\"Many NAS manufacturers have released firmware updates addressing macOS Tahoe compatibility:\"}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"Synology DSM Updates:\"})}),`\n`,(0,i.jsxs)(e.ul,{children:[`\n`,(0,i.jsx)(e.li,{children:\"DSM 7.2.2 and later include improved macOS Tahoe compatibility\"}),`\n`,(0,i.jsx)(e.li,{children:\"Update via Control Panel > Update & Restore\"}),`\n`]}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"QNAP QTS Updates:\"})}),`\n`,(0,i.jsxs)(e.ul,{children:[`\n`,(0,i.jsx)(e.li,{children:\"QTS 5.1.5 and later address SMB protocol issues\"}),`\n`,(0,i.jsx)(e.li,{children:\"Update via Control Panel > Firmware Update\"}),`\n`]}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"TrueNAS Updates:\"})}),`\n`,(0,i.jsxs)(e.ul,{children:[`\n`,(0,i.jsx)(e.li,{children:\"Samba 4.23 and later fix Tahoe-specific bugs\"}),`\n`,(0,i.jsx)(e.li,{children:\"Update via System > Update\"}),`\n`]}),`\n`,(0,i.jsx)(e.hr,{}),`\n`,(0,i.jsx)(e.h2,{id:\"nas-specific-solutions\",children:\"NAS-Specific Solutions\"}),`\n`,(0,i.jsx)(e.h3,{id:\"synology-configuration-guide\",children:\"Synology Configuration Guide\"}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.img,{alt:\"NAS Finder Locations\",src:\"/images/blog/macos-tahoe-smb-network-drive-nas-troubleshooting-guide-2025/nas-finder-locations.png\",width:\"800\",height:\"422\"})}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"Optimal DSM Settings for macOS Tahoe:\"})}),`\n`,(0,i.jsxs)(e.ol,{children:[`\n`,(0,i.jsxs)(e.li,{children:[`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"Enable SMB Service\"})}),`\n`,(0,i.jsxs)(e.ul,{children:[`\n`,(0,i.jsx)(e.li,{children:\"Control Panel > File Services > SMB > Enable SMB Service\"}),`\n`]}),`\n`]}),`\n`,(0,i.jsxs)(e.li,{children:[`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"Configure Advanced Settings\"})}),`\n`,(0,i.jsxs)(e.ul,{children:[`\n`,(0,i.jsx)(e.li,{children:\"Maximum SMB protocol: SMB3\"}),`\n`,(0,i.jsx)(e.li,{children:\"Minimum SMB protocol: SMB2\"}),`\n`,(0,i.jsx)(e.li,{children:\"Enable opportunistic locking: Checked\"}),`\n`,(0,i.jsx)(e.li,{children:\"Enable SMB durable handles: Checked\"}),`\n`]}),`\n`]}),`\n`,(0,i.jsxs)(e.li,{children:[`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"Enable Bonjour\"})}),`\n`,(0,i.jsxs)(e.ul,{children:[`\n`,(0,i.jsx)(e.li,{children:\"Control Panel > File Services > Advanced > Enable Bonjour Service Discovery\"}),`\n`]}),`\n`]}),`\n`,(0,i.jsxs)(e.li,{children:[`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"Create Dedicated macOS User\"})}),`\n`,(0,i.jsxs)(e.ul,{children:[`\n`,(0,i.jsx)(e.li,{children:\"Create a user specifically for macOS connections\"}),`\n`,(0,i.jsx)(e.li,{children:\"Assign appropriate share permissions\"}),`\n`,(0,i.jsx)(e.li,{children:\"Avoid using admin account for daily connections\"}),`\n`]}),`\n`]}),`\n`]}),`\n`,(0,i.jsx)(e.h3,{id:\"qnap-configuration-guide\",children:\"QNAP Configuration Guide\"}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"Optimal QTS Settings:\"})}),`\n`,(0,i.jsxs)(e.ol,{children:[`\n`,(0,i.jsxs)(e.li,{children:[`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"Enable Microsoft Networking\"})}),`\n`,(0,i.jsxs)(e.ul,{children:[`\n`,(0,i.jsx)(e.li,{children:\"Control Panel > Network & File Services > Win/Mac/NFS/WebDAV\"}),`\n`,(0,i.jsx)(e.li,{children:\"Enable file service for Microsoft networking\"}),`\n`]}),`\n`]}),`\n`,(0,i.jsxs)(e.li,{children:[`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"Configure SMB Version\"})}),`\n`,(0,i.jsxs)(e.ul,{children:[`\n`,(0,i.jsx)(e.li,{children:\"Click Advanced Options\"}),`\n`,(0,i.jsx)(e.li,{children:\"Set Highest SMB Version: SMB 3.1.1\"}),`\n`,(0,i.jsx)(e.li,{children:\"Set Lowest SMB Version: SMB 2.1\"}),`\n`]}),`\n`]}),`\n`,(0,i.jsxs)(e.li,{children:[`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"Enable AFP as Backup (Optional)\"})}),`\n`,(0,i.jsxs)(e.ul,{children:[`\n`,(0,i.jsx)(e.li,{children:\"While not recommended long-term, AFP can serve as temporary workaround\"}),`\n`,(0,i.jsx)(e.li,{children:\"Control Panel > Network & File Services > Mac File Service\"}),`\n`,(0,i.jsx)(e.li,{children:\"Enable AFP\"}),`\n`]}),`\n`]}),`\n`]}),`\n`,(0,i.jsx)(e.h3,{id:\"truenas-configuration-guide\",children:\"TrueNAS Configuration Guide\"}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"Optimal TrueNAS Settings:\"})}),`\n`,(0,i.jsxs)(e.ol,{children:[`\n`,(0,i.jsxs)(e.li,{children:[`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"Configure SMB Service\"})}),`\n`,(0,i.jsxs)(e.ul,{children:[`\n`,(0,i.jsx)(e.li,{children:\"Services > SMB > Configure\"}),`\n`,(0,i.jsx)(e.li,{children:\"Set NetBIOS Name to match your network\"}),`\n`,(0,i.jsx)(e.li,{children:\"Enable SMB1 Support: Disabled\"}),`\n`,(0,i.jsx)(e.li,{children:\"Enable SMB2/3 Support: Enabled\"}),`\n`]}),`\n`]}),`\n`,(0,i.jsxs)(e.li,{children:[`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"Share Configuration\"})}),`\n`,(0,i.jsxs)(e.ul,{children:[`\n`,(0,i.jsx)(e.li,{children:\"Sharing > SMB > Add\"}),`\n`,(0,i.jsx)(e.li,{children:\"Enable ACL: Checked\"}),`\n`,(0,i.jsx)(e.li,{children:\"Purpose: Default share parameters\"}),`\n`]}),`\n`]}),`\n`,(0,i.jsxs)(e.li,{children:[`\n`,(0,i.jsxs)(e.p,{children:[(0,i.jsx)(e.strong,{children:\"Auxiliary Parameters\"}),`\nAdd to SMB service configuration:`]}),`\n`,(0,i.jsx)(i.Fragment,{children:(0,i.jsx)(e.pre,{className:\"shiki shiki-themes github-light github-dark\",style:{\"--shiki-light\":\"#24292e\",\"--shiki-dark\":\"#e1e4e8\",\"--shiki-light-bg\":\"#fff\",\"--shiki-dark-bg\":\"#24292e\"},tabIndex:\"0\",icon:'<svg viewBox=\"0 0 24 24\"><path d=\"M 6,1 C 4.354992,1 3,2.354992 3,4 v 16 c 0,1.645008 1.354992,3 3,3 h 12 c 1.645008,0 3,-1.354992 3,-3 V 8 7 A 1.0001,1.0001 0 0 0 20.707031,6.2929687 l -5,-5 A 1.0001,1.0001 0 0 0 15,1 h -1 z m 0,2 h 7 v 3 c 0,1.645008 1.354992,3 3,3 h 3 v 11 c 0,0.564129 -0.435871,1 -1,1 H 6 C 5.4358712,21 5,20.564129 5,20 V 4 C 5,3.4358712 5.4358712,3 6,3 Z M 15,3.4140625 18.585937,7 H 16 C 15.435871,7 15,6.5641288 15,6 Z\" fill=\"currentColor\" /></svg>',children:(0,i.jsxs)(e.code,{children:[(0,i.jsx)(e.span,{className:\"line\",children:(0,i.jsx)(e.span,{children:\"server signing = auto\"})}),`\n`,(0,i.jsx)(e.span,{className:\"line\",children:(0,i.jsx)(e.span,{children:\"client signing = auto\"})}),`\n`,(0,i.jsx)(e.span,{className:\"line\",children:(0,i.jsx)(e.span,{children:\"server min protocol = SMB2\"})}),`\n`,(0,i.jsx)(e.span,{className:\"line\",children:(0,i.jsx)(e.span,{children:\"client min protocol = SMB2\"})})]})})}),`\n`]}),`\n`]}),`\n`,(0,i.jsx)(e.hr,{}),`\n`,(0,i.jsx)(e.h2,{id:\"advanced-troubleshooting\",children:\"Advanced Troubleshooting\"}),`\n`,(0,i.jsx)(e.h3,{id:\"diagnostic-commands\",children:\"Diagnostic Commands\"}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"Check SMB Connection Status:\"})}),`\n`,(0,i.jsx)(i.Fragment,{children:(0,i.jsx)(e.pre,{className:\"shiki shiki-themes github-light github-dark\",style:{\"--shiki-light\":\"#24292e\",\"--shiki-dark\":\"#e1e4e8\",\"--shiki-light-bg\":\"#fff\",\"--shiki-dark-bg\":\"#24292e\"},tabIndex:\"0\",icon:'<svg viewBox=\"0 0 24 24\"><path d=\"m 4,4 a 1,1 0 0 0 -0.7070312,0.2929687 1,1 0 0 0 0,1.4140625 L 8.5859375,11 3.2929688,16.292969 a 1,1 0 0 0 0,1.414062 1,1 0 0 0 1.4140624,0 l 5.9999998,-6 a 1.0001,1.0001 0 0 0 0,-1.414062 L 4.7070312,4.2929687 A 1,1 0 0 0 4,4 Z m 8,14 a 1,1 0 0 0 -1,1 1,1 0 0 0 1,1 h 8 a 1,1 0 0 0 1,-1 1,1 0 0 0 -1,-1 z\" fill=\"currentColor\" /></svg>',children:(0,i.jsx)(e.code,{children:(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6F42C1\",\"--shiki-dark\":\"#B392F0\"},children:\"smbutil\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" statshares\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#005CC5\",\"--shiki-dark\":\"#79B8FF\"},children:\" -a\"})]})})})}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"View Active SMB Sessions:\"})}),`\n`,(0,i.jsx)(i.Fragment,{children:(0,i.jsx)(e.pre,{className:\"shiki shiki-themes github-light github-dark\",style:{\"--shiki-light\":\"#24292e\",\"--shiki-dark\":\"#e1e4e8\",\"--shiki-light-bg\":\"#fff\",\"--shiki-dark-bg\":\"#24292e\"},tabIndex:\"0\",icon:'<svg viewBox=\"0 0 24 24\"><path d=\"m 4,4 a 1,1 0 0 0 -0.7070312,0.2929687 1,1 0 0 0 0,1.4140625 L 8.5859375,11 3.2929688,16.292969 a 1,1 0 0 0 0,1.414062 1,1 0 0 0 1.4140624,0 l 5.9999998,-6 a 1.0001,1.0001 0 0 0 0,-1.414062 L 4.7070312,4.2929687 A 1,1 0 0 0 4,4 Z m 8,14 a 1,1 0 0 0 -1,1 1,1 0 0 0 1,1 h 8 a 1,1 0 0 0 1,-1 1,1 0 0 0 -1,-1 z\" fill=\"currentColor\" /></svg>',children:(0,i.jsx)(e.code,{children:(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6F42C1\",\"--shiki-dark\":\"#B392F0\"},children:\"smbutil\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" view\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" //user@192.168.1.100\"})]})})})}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"Test SMB Connectivity:\"})}),`\n`,(0,i.jsx)(i.Fragment,{children:(0,i.jsx)(e.pre,{className:\"shiki shiki-themes github-light github-dark\",style:{\"--shiki-light\":\"#24292e\",\"--shiki-dark\":\"#e1e4e8\",\"--shiki-light-bg\":\"#fff\",\"--shiki-dark-bg\":\"#24292e\"},tabIndex:\"0\",icon:'<svg viewBox=\"0 0 24 24\"><path d=\"m 4,4 a 1,1 0 0 0 -0.7070312,0.2929687 1,1 0 0 0 0,1.4140625 L 8.5859375,11 3.2929688,16.292969 a 1,1 0 0 0 0,1.414062 1,1 0 0 0 1.4140624,0 l 5.9999998,-6 a 1.0001,1.0001 0 0 0 0,-1.414062 L 4.7070312,4.2929687 A 1,1 0 0 0 4,4 Z m 8,14 a 1,1 0 0 0 -1,1 1,1 0 0 0 1,1 h 8 a 1,1 0 0 0 1,-1 1,1 0 0 0 -1,-1 z\" fill=\"currentColor\" /></svg>',children:(0,i.jsx)(e.code,{children:(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6F42C1\",\"--shiki-dark\":\"#B392F0\"},children:\"nc\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#005CC5\",\"--shiki-dark\":\"#79B8FF\"},children:\" -zv\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#005CC5\",\"--shiki-dark\":\"#79B8FF\"},children:\" 192.168.1.100\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#005CC5\",\"--shiki-dark\":\"#79B8FF\"},children:\" 445\"})]})})})}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"Monitor SMB Traffic:\"})}),`\n`,(0,i.jsx)(i.Fragment,{children:(0,i.jsx)(e.pre,{className:\"shiki shiki-themes github-light github-dark\",style:{\"--shiki-light\":\"#24292e\",\"--shiki-dark\":\"#e1e4e8\",\"--shiki-light-bg\":\"#fff\",\"--shiki-dark-bg\":\"#24292e\"},tabIndex:\"0\",icon:'<svg viewBox=\"0 0 24 24\"><path d=\"m 4,4 a 1,1 0 0 0 -0.7070312,0.2929687 1,1 0 0 0 0,1.4140625 L 8.5859375,11 3.2929688,16.292969 a 1,1 0 0 0 0,1.414062 1,1 0 0 0 1.4140624,0 l 5.9999998,-6 a 1.0001,1.0001 0 0 0 0,-1.414062 L 4.7070312,4.2929687 A 1,1 0 0 0 4,4 Z m 8,14 a 1,1 0 0 0 -1,1 1,1 0 0 0 1,1 h 8 a 1,1 0 0 0 1,-1 1,1 0 0 0 -1,-1 z\" fill=\"currentColor\" /></svg>',children:(0,i.jsx)(e.code,{children:(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6F42C1\",\"--shiki-dark\":\"#B392F0\"},children:\"sudo\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" tcpdump\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#005CC5\",\"--shiki-dark\":\"#79B8FF\"},children:\" -i\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" any\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" port\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#005CC5\",\"--shiki-dark\":\"#79B8FF\"},children:\" 445\"})]})})})}),`\n`,(0,i.jsx)(e.h3,{id:\"logging-and-debugging\",children:\"Logging and Debugging\"}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"Enable SMB Debug Logging:\"})}),`\n`,(0,i.jsx)(i.Fragment,{children:(0,i.jsx)(e.pre,{className:\"shiki shiki-themes github-light github-dark\",style:{\"--shiki-light\":\"#24292e\",\"--shiki-dark\":\"#e1e4e8\",\"--shiki-light-bg\":\"#fff\",\"--shiki-dark-bg\":\"#24292e\"},tabIndex:\"0\",icon:'<svg viewBox=\"0 0 24 24\"><path d=\"m 4,4 a 1,1 0 0 0 -0.7070312,0.2929687 1,1 0 0 0 0,1.4140625 L 8.5859375,11 3.2929688,16.292969 a 1,1 0 0 0 0,1.414062 1,1 0 0 0 1.4140624,0 l 5.9999998,-6 a 1.0001,1.0001 0 0 0 0,-1.414062 L 4.7070312,4.2929687 A 1,1 0 0 0 4,4 Z m 8,14 a 1,1 0 0 0 -1,1 1,1 0 0 0 1,1 h 8 a 1,1 0 0 0 1,-1 1,1 0 0 0 -1,-1 z\" fill=\"currentColor\" /></svg>',children:(0,i.jsx)(e.code,{children:(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6F42C1\",\"--shiki-dark\":\"#B392F0\"},children:\"sudo\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" sysctl\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#005CC5\",\"--shiki-dark\":\"#79B8FF\"},children:\" -w\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" net.smb.fs.loglevel=\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#005CC5\",\"--shiki-dark\":\"#79B8FF\"},children:\"5\"})]})})})}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"View SMB Logs:\"})}),`\n`,(0,i.jsx)(i.Fragment,{children:(0,i.jsx)(e.pre,{className:\"shiki shiki-themes github-light github-dark\",style:{\"--shiki-light\":\"#24292e\",\"--shiki-dark\":\"#e1e4e8\",\"--shiki-light-bg\":\"#fff\",\"--shiki-dark-bg\":\"#24292e\"},tabIndex:\"0\",icon:'<svg viewBox=\"0 0 24 24\"><path d=\"m 4,4 a 1,1 0 0 0 -0.7070312,0.2929687 1,1 0 0 0 0,1.4140625 L 8.5859375,11 3.2929688,16.292969 a 1,1 0 0 0 0,1.414062 1,1 0 0 0 1.4140624,0 l 5.9999998,-6 a 1.0001,1.0001 0 0 0 0,-1.414062 L 4.7070312,4.2929687 A 1,1 0 0 0 4,4 Z m 8,14 a 1,1 0 0 0 -1,1 1,1 0 0 0 1,1 h 8 a 1,1 0 0 0 1,-1 1,1 0 0 0 -1,-1 z\" fill=\"currentColor\" /></svg>',children:(0,i.jsx)(e.code,{children:(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6F42C1\",\"--shiki-dark\":\"#B392F0\"},children:\"log\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" show\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#005CC5\",\"--shiki-dark\":\"#79B8FF\"},children:\" --predicate\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:` 'subsystem == \"com.apple.smbfs\"'`}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#005CC5\",\"--shiki-dark\":\"#79B8FF\"},children:\" --last\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" 1h\"})]})})})}),`\n`,(0,i.jsx)(e.h3,{id:\"reset-all-smb-settings\",children:\"Reset All SMB Settings\"}),`\n`,(0,i.jsx)(e.p,{children:\"If all else fails, reset SMB configuration to defaults:\"}),`\n`,(0,i.jsx)(i.Fragment,{children:(0,i.jsx)(e.pre,{className:\"shiki shiki-themes github-light github-dark\",style:{\"--shiki-light\":\"#24292e\",\"--shiki-dark\":\"#e1e4e8\",\"--shiki-light-bg\":\"#fff\",\"--shiki-dark-bg\":\"#24292e\"},tabIndex:\"0\",icon:'<svg viewBox=\"0 0 24 24\"><path d=\"m 4,4 a 1,1 0 0 0 -0.7070312,0.2929687 1,1 0 0 0 0,1.4140625 L 8.5859375,11 3.2929688,16.292969 a 1,1 0 0 0 0,1.414062 1,1 0 0 0 1.4140624,0 l 5.9999998,-6 a 1.0001,1.0001 0 0 0 0,-1.414062 L 4.7070312,4.2929687 A 1,1 0 0 0 4,4 Z m 8,14 a 1,1 0 0 0 -1,1 1,1 0 0 0 1,1 h 8 a 1,1 0 0 0 1,-1 1,1 0 0 0 -1,-1 z\" fill=\"currentColor\" /></svg>',children:(0,i.jsxs)(e.code,{children:[(0,i.jsx)(e.span,{className:\"line\",children:(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6A737D\",\"--shiki-dark\":\"#6A737D\"},children:\"# Remove custom configuration\"})}),`\n`,(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6F42C1\",\"--shiki-dark\":\"#B392F0\"},children:\"sudo\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" rm\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" /etc/nsmb.conf\"})]}),`\n`,(0,i.jsx)(e.span,{className:\"line\"}),`\n`,(0,i.jsx)(e.span,{className:\"line\",children:(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6A737D\",\"--shiki-dark\":\"#6A737D\"},children:\"# Reset SMB-related preferences\"})}),`\n`,(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6F42C1\",\"--shiki-dark\":\"#B392F0\"},children:\"defaults\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" delete\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" com.apple.desktopservices\"})]}),`\n`,(0,i.jsx)(e.span,{className:\"line\"}),`\n`,(0,i.jsx)(e.span,{className:\"line\",children:(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6A737D\",\"--shiki-dark\":\"#6A737D\"},children:\"# Flush caches\"})}),`\n`,(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6F42C1\",\"--shiki-dark\":\"#B392F0\"},children:\"sudo\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" dscacheutil\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#005CC5\",\"--shiki-dark\":\"#79B8FF\"},children:\" -flushcache\"})]}),`\n`,(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6F42C1\",\"--shiki-dark\":\"#B392F0\"},children:\"sudo\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" killall\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#005CC5\",\"--shiki-dark\":\"#79B8FF\"},children:\" -HUP\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" mDNSResponder\"})]}),`\n`,(0,i.jsx)(e.span,{className:\"line\"}),`\n`,(0,i.jsx)(e.span,{className:\"line\",children:(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6A737D\",\"--shiki-dark\":\"#6A737D\"},children:\"# Restart\"})}),`\n`,(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6F42C1\",\"--shiki-dark\":\"#B392F0\"},children:\"sudo\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" reboot\"})]})]})})}),`\n`,(0,i.jsx)(e.hr,{}),`\n`,(0,i.jsx)(e.h2,{id:\"prevention-and-best-practices\",children:\"Prevention and Best Practices\"}),`\n`,(0,i.jsx)(e.h3,{id:\"recommended-network-configuration\",children:\"Recommended Network Configuration\"}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"For Home/Small Office:\"})}),`\n`,(0,i.jsxs)(e.table,{children:[(0,i.jsx)(e.thead,{children:(0,i.jsxs)(e.tr,{children:[(0,i.jsx)(e.th,{children:\"Setting\"}),(0,i.jsx)(e.th,{children:\"Recommendation\"})]})}),(0,i.jsxs)(e.tbody,{children:[(0,i.jsxs)(e.tr,{children:[(0,i.jsx)(e.td,{children:\"Network Protocol\"}),(0,i.jsx)(e.td,{children:\"SMB 3\"})]}),(0,i.jsxs)(e.tr,{children:[(0,i.jsx)(e.td,{children:\"Authentication\"}),(0,i.jsx)(e.td,{children:\"User-based with strong passwords\"})]}),(0,i.jsxs)(e.tr,{children:[(0,i.jsx)(e.td,{children:\"Connection Type\"}),(0,i.jsx)(e.td,{children:\"Wired Ethernet preferred\"})]}),(0,i.jsxs)(e.tr,{children:[(0,i.jsx)(e.td,{children:\"DNS\"}),(0,i.jsx)(e.td,{children:\"Local DNS server or static IP\"})]})]})]}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"For Enterprise:\"})}),`\n`,(0,i.jsxs)(e.table,{children:[(0,i.jsx)(e.thead,{children:(0,i.jsxs)(e.tr,{children:[(0,i.jsx)(e.th,{children:\"Setting\"}),(0,i.jsx)(e.th,{children:\"Recommendation\"})]})}),(0,i.jsxs)(e.tbody,{children:[(0,i.jsxs)(e.tr,{children:[(0,i.jsx)(e.td,{children:\"Network Protocol\"}),(0,i.jsx)(e.td,{children:\"SMB 3.1.1 with signing\"})]}),(0,i.jsxs)(e.tr,{children:[(0,i.jsx)(e.td,{children:\"Authentication\"}),(0,i.jsx)(e.td,{children:\"Active Directory integration\"})]}),(0,i.jsxs)(e.tr,{children:[(0,i.jsx)(e.td,{children:\"Connection Type\"}),(0,i.jsx)(e.td,{children:\"Dedicated VLAN for storage\"})]}),(0,i.jsxs)(e.tr,{children:[(0,i.jsx)(e.td,{children:\"Backup\"}),(0,i.jsx)(e.td,{children:\"Multiple Time Machine destinations\"})]})]})]}),`\n`,(0,i.jsx)(e.h3,{id:\"maintenance-checklist\",children:\"Maintenance Checklist\"}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"Weekly:\"})}),`\n`,(0,i.jsxs)(e.ul,{className:\"contains-task-list\",children:[`\n`,(0,i.jsxs)(e.li,{className:\"task-list-item\",children:[(0,i.jsx)(e.input,{type:\"checkbox\",disabled:!0}),\" \",\"Verify Time Machine backups completing successfully\"]}),`\n`,(0,i.jsxs)(e.li,{className:\"task-list-item\",children:[(0,i.jsx)(e.input,{type:\"checkbox\",disabled:!0}),\" \",\"Check NAS storage health and available space\"]}),`\n`,(0,i.jsxs)(e.li,{className:\"task-list-item\",children:[(0,i.jsx)(e.input,{type:\"checkbox\",disabled:!0}),\" \",\"Review system logs for connection errors\"]}),`\n`]}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"Monthly:\"})}),`\n`,(0,i.jsxs)(e.ul,{className:\"contains-task-list\",children:[`\n`,(0,i.jsxs)(e.li,{className:\"task-list-item\",children:[(0,i.jsx)(e.input,{type:\"checkbox\",disabled:!0}),\" \",\"Check for NAS firmware updates\"]}),`\n`,(0,i.jsxs)(e.li,{className:\"task-list-item\",children:[(0,i.jsx)(e.input,{type:\"checkbox\",disabled:!0}),\" \",\"Verify Keychain entries for network shares\"]}),`\n`,(0,i.jsxs)(e.li,{className:\"task-list-item\",children:[(0,i.jsx)(e.input,{type:\"checkbox\",disabled:!0}),\" \",\"Test manual mount/unmount cycle\"]}),`\n`]}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"After macOS Updates:\"})}),`\n`,(0,i.jsxs)(e.ul,{className:\"contains-task-list\",children:[`\n`,(0,i.jsxs)(e.li,{className:\"task-list-item\",children:[(0,i.jsx)(e.input,{type:\"checkbox\",disabled:!0}),\" \",\"Review Apple release notes for SMB changes\"]}),`\n`,(0,i.jsxs)(e.li,{className:\"task-list-item\",children:[(0,i.jsx)(e.input,{type:\"checkbox\",disabled:!0}),\" \",\"Test all network share connections\"]}),`\n`,(0,i.jsxs)(e.li,{className:\"task-list-item\",children:[(0,i.jsx)(e.input,{type:\"checkbox\",disabled:!0}),\" \",\"Verify Time Machine backup operation\"]}),`\n`,(0,i.jsxs)(e.li,{className:\"task-list-item\",children:[(0,i.jsx)(e.input,{type:\"checkbox\",disabled:!0}),\" \",\"Check community forums for new issues\"]}),`\n`]}),`\n`,(0,i.jsx)(e.hr,{}),`\n`,(0,i.jsx)(e.h2,{id:\"when-to-contact-support\",children:\"When to Contact Support\"}),`\n`,(0,i.jsx)(e.h3,{id:\"apple-support\",children:\"Apple Support\"}),`\n`,(0,i.jsx)(e.p,{children:\"Contact Apple Support if:\"}),`\n`,(0,i.jsxs)(e.ul,{children:[`\n`,(0,i.jsx)(e.li,{children:\"Issues persist after all troubleshooting steps\"}),`\n`,(0,i.jsx)(e.li,{children:\"Problems affect multiple Macs on the same network\"}),`\n`,(0,i.jsx)(e.li,{children:\"Errors appear in Console logs indicating system bugs\"}),`\n`]}),`\n`,(0,i.jsx)(e.h3,{id:\"nas-manufacturer-support\",children:\"NAS Manufacturer Support\"}),`\n`,(0,i.jsx)(e.p,{children:\"Contact your NAS manufacturer if:\"}),`\n`,(0,i.jsxs)(e.ul,{children:[`\n`,(0,i.jsx)(e.li,{children:\"Firmware updates don't resolve issues\"}),`\n`,(0,i.jsx)(e.li,{children:\"Hardware diagnostics indicate problems\"}),`\n`,(0,i.jsx)(e.li,{children:\"Other non-Mac devices also experience connectivity issues\"}),`\n`]}),`\n`,(0,i.jsx)(e.hr,{}),`\n`,(0,i.jsx)(e.h2,{id:\"conclusion-navigating-smb-challenges-in-macos-tahoe\",children:\"Conclusion: Navigating SMB Challenges in macOS Tahoe\"}),`\n`,(0,i.jsxs)(e.p,{children:[\"The SMB connectivity issues in macOS Tahoe represent a significant challenge for users relying on network storage. While Apple has addressed some problems in subsequent updates, many issues persist in version 26.2. The solutions outlined in this guide\\u2014particularly the \",(0,i.jsx)(e.code,{children:\"/etc/nsmb.conf\"}),\" configuration\\u2014provide reliable workarounds for most common problems.\"]}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"Key Takeaways:\"})}),`\n`,(0,i.jsxs)(e.ol,{children:[`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"Configuration is Key\"}),\": The \",(0,i.jsx)(e.code,{children:\"/etc/nsmb.conf\"}),\" file is your primary tool for resolving compatibility issues\"]}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"Keep Firmware Updated\"}),\": NAS manufacturers continue releasing compatibility patches\"]}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"Monitor for Updates\"}),\": Apple may address remaining issues in macOS 26.3 and beyond\"]}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"Consider Alternatives\"}),\": Third-party auto-mount tools provide more reliable solutions than native macOS functionality\"]}),`\n`]}),`\n`,(0,i.jsxs)(e.p,{children:[\"For Time Machine users experiencing persistent issues, consider reading our \",(0,i.jsx)(e.a,{href:\"/blog/macos-tahoe-time-machine-complete-troubleshooting-guide-2025\",children:\"Time Machine Complete Troubleshooting Guide\"}),\" for additional backup-specific solutions.\"]}),`\n`,(0,i.jsxs)(e.p,{children:[\"If you're experiencing related connectivity issues with external storage devices, our \",(0,i.jsx)(e.a,{href:\"/blog/macos-external-ssd-troubleshooting-guide-2025\",children:\"External SSD & Storage Troubleshooting Guide\"}),\" covers USB and Thunderbolt drive problems that may compound NAS connectivity challenges.\"]}),`\n`,(0,i.jsx)(e.hr,{}),`\n`,(0,i.jsx)(e.h2,{id:\"frequently-asked-questions\",children:\"Frequently Asked Questions\"}),`\n`,(0,i.jsx)(e.h3,{id:\"why-did-my-nas-stop-working-after-upgrading-to-macos-tahoe\",children:\"Why did my NAS stop working after upgrading to macOS Tahoe?\"}),`\n`,(0,i.jsx)(e.p,{children:\"macOS Tahoe changed default SMB settings to require stricter security configurations. Many NAS devices are configured with more relaxed SMB settings for compatibility, which now conflict with Tahoe's requirements.\"}),`\n`,(0,i.jsx)(e.h3,{id:\"is-it-safe-to-disable-smb-signing\",children:\"Is it safe to disable SMB signing?\"}),`\n`,(0,i.jsx)(e.p,{children:\"For home and small office environments, disabling SMB signing is generally acceptable. For enterprise environments handling sensitive data, consult your IT security team before making this change.\"}),`\n`,(0,i.jsx)(e.h3,{id:\"will-apple-fix-these-smb-issues\",children:\"Will Apple fix these SMB issues?\"}),`\n`,(0,i.jsx)(e.p,{children:\"Apple has made some improvements in 26.1 and 26.2, but significant issues remain. Community feedback suggests these are priority issues for future updates, but no timeline has been announced.\"}),`\n`,(0,i.jsx)(e.h3,{id:\"can-i-use-afp-instead-of-smb\",children:\"Can I use AFP instead of SMB?\"}),`\n`,(0,i.jsx)(e.p,{children:\"AFP (Apple Filing Protocol) still works as a client in macOS Tahoe and may provide a temporary workaround. However, AFP is deprecated and may be removed in future macOS versions. It's recommended to resolve SMB issues rather than relying on AFP long-term.\"}),`\n`,(0,i.jsx)(e.h3,{id:\"why-do-my-network-drives-disconnect-when-my-mac-sleeps\",children:\"Why do my network drives disconnect when my Mac sleeps?\"}),`\n`,(0,i.jsx)(e.p,{children:\"macOS Tahoe's power management aggressively disconnects idle network connections. Adjusting Power Nap settings and using TCP keepalive configurations can help maintain connections during sleep cycles.\"}),`\n`,(0,i.jsx)(e.h3,{id:\"how-do-i-know-if-my-nsmbconf-changes-are-working\",children:\"How do I know if my nsmb.conf changes are working?\"}),`\n`,(0,i.jsxs)(e.p,{children:[\"After creating or modifying \",(0,i.jsx)(e.code,{children:\"/etc/nsmb.conf\"}),\" and restarting, use \",(0,i.jsx)(e.code,{children:\"smbutil statshares -a\"}),\" to verify connection parameters. You should see your configured protocol version and signing settings reflected in the output.\"]}),`\n`,(0,i.jsx)(e.hr,{}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.em,{children:\"Last Updated: December 28, 2025\"})}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.em,{children:\"This guide is based on extensive testing with macOS Tahoe 26.2, Synology DSM 7.2.2, QNAP QTS 5.1.5, and TrueNAS SCALE 24.04. Solutions have been verified by community testing and user feedback.\"})})]})}function o(n={}){let{wrapper:e}=n.components||{};return e?(0,i.jsx)(e,{...n,children:(0,i.jsx)(d,{...n})}):d(n)}return F(S);})();\n;return Component;","toc":[{"title":"Executive Summary: SMB Connectivity Crisis in macOS Tahoe","url":"#executive-summary-smb-connectivity-crisis-in-macos-tahoe","depth":2},{"title":"The Scale of the Problem","url":"#the-scale-of-the-problem","depth":3},{"title":"Root Cause Analysis","url":"#root-cause-analysis","depth":3},{"title":"Quick Diagnostic: Identify Your Specific Problem","url":"#quick-diagnostic-identify-your-specific-problem","depth":2},{"title":"Category A: Cannot Connect at All","url":"#category-a-cannot-connect-at-all","depth":3},{"title":"Category B: Connections Drop Unexpectedly","url":"#category-b-connections-drop-unexpectedly","depth":3},{"title":"Category C: Auto-Mount Not Working","url":"#category-c-auto-mount-not-working","depth":3},{"title":"Category D: Time Machine Backup Failures","url":"#category-d-time-machine-backup-failures","depth":3},{"title":"Core Solution: Configure /etc/nsmb.conf","url":"#core-solution-configure-etcnsmbconf","depth":2},{"title":"Step-by-Step Configuration","url":"#step-by-step-configuration","depth":3},{"title":"Configuration Options Explained","url":"#configuration-options-explained","depth":3},{"title":"Authentication and Connection Fixes","url":"#authentication-and-connection-fixes","depth":2},{"title":"Fix 1: Reset Keychain Entries for Network Shares","url":"#fix-1-reset-keychain-entries-for-network-shares","depth":3},{"title":"Fix 2: Use IP Address Instead of Hostname","url":"#fix-2-use-ip-address-instead-of-hostname","depth":3},{"title":"Fix 3: Verify SMB Protocol Version on NAS","url":"#fix-3-verify-smb-protocol-version-on-nas","depth":3},{"title":"Fix 4: Flush DNS Cache","url":"#fix-4-flush-dns-cache","depth":3},{"title":"Connection Stability Fixes","url":"#connection-stability-fixes","depth":2},{"title":"Fix 5: Disable SMB Multichannel","url":"#fix-5-disable-smb-multichannel","depth":3},{"title":"Fix 6: Adjust TCP KeepAlive Settings","url":"#fix-6-adjust-tcp-keepalive-settings","depth":3},{"title":"Fix 7: Disable Power Nap for Network Operations","url":"#fix-7-disable-power-nap-for-network-operations","depth":3},{"title":"Fix 8: Use Wired Connection When Possible","url":"#fix-8-use-wired-connection-when-possible","depth":3},{"title":"Auto-Mount Configuration Fixes","url":"#auto-mount-configuration-fixes","depth":2},{"title":"Fix 9: Create Custom Mount Points","url":"#fix-9-create-custom-mount-points","depth":3},{"title":"Fix 10: Configure Login Items Properly","url":"#fix-10-configure-login-items-properly","depth":3},{"title":"Fix 11: Use Automator for Reliable Auto-Mount","url":"#fix-11-use-automator-for-reliable-auto-mount","depth":3},{"title":"Fix 12: Third-Party Auto-Mount Solutions","url":"#fix-12-third-party-auto-mount-solutions","depth":3},{"title":"Time Machine Backup Fixes","url":"#time-machine-backup-fixes","depth":2},{"title":"Fix 13: Configure nsmb.conf for Time Machine","url":"#fix-13-configure-nsmbconf-for-time-machine","depth":3},{"title":"Fix 14: Fix APFS Container Names","url":"#fix-14-fix-apfs-container-names","depth":3},{"title":"Fix 15: Reset Time Machine Configuration","url":"#fix-15-reset-time-machine-configuration","depth":3},{"title":"Fix 16: Update NAS Firmware","url":"#fix-16-update-nas-firmware","depth":3},{"title":"NAS-Specific Solutions","url":"#nas-specific-solutions","depth":2},{"title":"Synology Configuration Guide","url":"#synology-configuration-guide","depth":3},{"title":"QNAP Configuration Guide","url":"#qnap-configuration-guide","depth":3},{"title":"TrueNAS Configuration Guide","url":"#truenas-configuration-guide","depth":3},{"title":"Advanced Troubleshooting","url":"#advanced-troubleshooting","depth":2},{"title":"Diagnostic Commands","url":"#diagnostic-commands","depth":3},{"title":"Logging and Debugging","url":"#logging-and-debugging","depth":3},{"title":"Reset All SMB Settings","url":"#reset-all-smb-settings","depth":3},{"title":"Prevention and Best Practices","url":"#prevention-and-best-practices","depth":2},{"title":"Recommended Network Configuration","url":"#recommended-network-configuration","depth":3},{"title":"Maintenance Checklist","url":"#maintenance-checklist","depth":3},{"title":"When to Contact Support","url":"#when-to-contact-support","depth":2},{"title":"Apple Support","url":"#apple-support","depth":3},{"title":"NAS Manufacturer Support","url":"#nas-manufacturer-support","depth":3},{"title":"Conclusion: Navigating SMB Challenges in macOS Tahoe","url":"#conclusion-navigating-smb-challenges-in-macos-tahoe","depth":2},{"title":"Frequently Asked Questions","url":"#frequently-asked-questions","depth":2},{"title":"Why did my NAS stop working after upgrading to macOS Tahoe?","url":"#why-did-my-nas-stop-working-after-upgrading-to-macos-tahoe","depth":3},{"title":"Is it safe to disable SMB signing?","url":"#is-it-safe-to-disable-smb-signing","depth":3},{"title":"Will Apple fix these SMB issues?","url":"#will-apple-fix-these-smb-issues","depth":3},{"title":"Can I use AFP instead of SMB?","url":"#can-i-use-afp-instead-of-smb","depth":3},{"title":"Why do my network drives disconnect when my Mac sleeps?","url":"#why-do-my-network-drives-disconnect-when-my-mac-sleeps","depth":3},{"title":"How do I know if my nsmb.conf changes are working?","url":"#how-do-i-know-if-my-nsmbconf-changes-are-working","depth":3}],"estimatedTime":14}