Skip to content
Network and Access

Connect Mac to NAS Over SMB: Setup Guide

Mount your Synology or QNAP share in Finder using smb://, save the password to Keychain, and have it reconnect every time you log in.

Apple iMac displaying ocean view. Elegant workspace with ambient lighting.

My first real NAS was a Synology DS220+, and I spent a frustrating half hour that first evening dragging its icon around Finder trying to make a share appear. Turns out I was overcomplicating a job that takes about ninety seconds once you know the trick.

The trick is a little URL: smb:// followed by your NAS address. That is the whole secret, and everything else in this guide is just polishing.

SMB is the file-sharing protocol Windows made popular, and modern macOS speaks it fluently. Apple used to push its own AFP protocol, but that is dead now, so on any Mac running Big Sur or later you want SMB every single time.

Find your NAS address first

Before you touch Finder, you need to know where your NAS lives on the network. That means either its IP address or its local hostname.

On a Synology, log into DSM in a browser and check Control Panel, Info Center. On a QNAP, the address shows on the QTS login screen and in the Network settings. Write down something like 192.168.1.42.

Most home NAS boxes also answer to a friendly name. A Synology called "HomeVault" is usually reachable at HomeVault.local thanks to Bonjour, Apple's zero-config networking. That name is easier to remember than an IP, but IPs are more reliable if your router keeps reassigning addresses.

Bright modern workspace with laptop, potted plants, and desk lamp near a window.

Connect to the share with Connect to Server

Here is the ninety-second version. Open Finder, then from the menu bar choose Go, Connect to Server. The keyboard shortcut is Command plus K, and I use it so often my muscle memory hits it without thinking.

In the box that appears, type your address with the protocol in front:

  1. Type smb://192.168.1.42 (swap in your own IP or the .local name).
  2. Click the plus button to save it to your favorites so you never retype it.
  3. Click Connect.
  4. When prompted, choose Registered User, then enter your NAS username and password. This is your DSM or QTS account, not your Mac password.
  5. Tick Remember this password in my keychain.
  6. Pick the share you want from the list, for example home or Media, and click OK.

The share now appears in Finder under Locations in the sidebar, and a drive icon may pop onto your desktop. You can drag files in and out exactly like a local folder.

Save the login so you stop retyping it

That keychain checkbox matters more than it looks. When you tick it, macOS stores the NAS username and password in your login keychain, and future connections happen silently.

If you ever change the password on the NAS side, the old saved entry will start failing with a login error. To fix it, open the Keychain Access app (or Passwords in System Settings on Sonoma and later), search for your NAS name, and delete the stale entry. The next connection will prompt fresh and re-save the correct password.

Make the share reconnect at login

A mounted share vanishes when you restart or when the Mac sleeps for a long stretch. If you want it back automatically every time you log in, set it as a login item.

First mount the share using the steps above. Then:

  1. Open System Settings, General, Login Items.
  2. Under "Open at Login" click the plus button.
  3. Navigate to the mounted share (it shows under Locations), select it, and click Open.

Now the share mounts a few seconds after you reach the desktop. On older macOS the path was System Preferences, Users and Groups, Login Items, but the idea is identical.

SMB versions and why speed sometimes crawls

Not all SMB is equal. The protocol has gone through several versions, and the newest one, SMB3, brings encryption and much better throughput. Every NAS worth buying supports it, and so does macOS.

The problem shows up when an old setting forces an ancient version. If your transfers to a gigabit NAS crawl along at 20 MB/s instead of the 110 MB/s you expected, dig into the NAS control panel and confirm the maximum SMB protocol is set to SMB3 and the minimum is not stuck at SMB1.

SMB version Status Use it?
SMB1 (CIFS) Ancient, insecure No, disable it
SMB2 Fine, widely supported Acceptable fallback
SMB3 Fast, encrypted Yes, default choice

Apple has good background reading if you want the deeper detail on how macOS negotiates these versions, in their macOS SMB support notes. For the NAS side, Synology's own SMB access guide walks through the DSM settings screen by screen.

The errors you will probably hit

A handful of failures come up again and again. Here are the ones I get emailed about most.

"There was a problem connecting to the server." Nine times out of ten this is the wrong address. Double-check the IP, and try pinging it from Terminal with ping 192.168.1.42. No reply means a network problem, not a Finder problem.

"The operation can't be completed because the original item can't be found." The mount dropped after sleep. Unmount by clicking the eject arrow next to the share in Finder, then reconnect with Command K.

A login loop that keeps rejecting a correct password. That is the stale keychain entry again. Delete it as described earlier and try once more.

One more that trips people up: if the NAS username has a space or a special character, wrap the whole thing carefully or, better, rename the account to something plain like dane on the NAS side.

And if Finder shows the share but every folder reads "you do not have permission," that is a NAS side issue, not a Mac one. Log into DSM or QTS, open that shared folder's permissions, and confirm your user actually has read or write access. Finder is only repeating what the NAS told it.

A quick word on wired versus Wi-Fi

People often blame SMB for slow speeds when the real culprit is Wi-Fi. A wired gigabit connection gives you a steady 110 MB/s ceiling, enough to copy a 4 GB movie in well under a minute.

Wi-Fi is a different animal. Even a strong 5 GHz signal fluctuates, and a busy household can drag a large copy down to a crawl halfway through. If you do serious file work, plug the Mac into the router or a switch with an ethernet cable, and even a cheap USB-C adapter for a MacBook makes a real difference.

For everyday browsing of photos and documents, Wi-Fi is perfectly fine. It is only the big sustained transfers where the cable earns its keep.

Where to go from here

Once the basic mount works, the fun starts. You can point Time Machine at an SMB share for backups, set Photos to store its library on the NAS, or use the mounted folder as a scratch drive for video work if your network is quick enough.

Get the smb:// mount solid first, though. Almost every Mac-to-NAS headache I have ever untangled came down to a wrong address or a stale saved password, and both take under a minute to fix once you know where to look.

Frequently asked questions

Should I use AFP or SMB to connect my Mac to a NAS?

Use SMB. Apple deprecated AFP years ago and modern macOS handles SMB3 natively with good speed and encryption. On any Mac running Big Sur or newer, always choose the smb:// address rather than afp://.

Why does my NAS share disappear after the Mac sleeps?

macOS drops idle network mounts to save resources, so the share can vanish after a long sleep. Just reconnect with Command K, or add it as a Login Item so it remounts automatically. Setting a static IP for the NAS also reduces these drops.

What username and password does the NAS ask for?

It wants the account you created inside the NAS software (DSM on Synology, QTS on QNAP), not your macOS login. If you only have an admin account, log into the NAS web interface first and create a normal user for daily file access.

Can I connect to my NAS over SMB from outside my home?

You can, but exposing SMB directly to the internet is risky. Use a VPN into your home network instead, or the NAS vendor's own remote access service like Synology QuickConnect. Then connect over smb:// as if you were home.

My transfers are slow over SMB. What is wrong?

First check the NAS is set to allow SMB3 as the maximum protocol, since a forced older version cripples speed. Then confirm both the Mac and NAS are on wired gigabit, not Wi-Fi. A single client should reach roughly 110 MB/s on gigabit.

Dev Patel, Senior Homelab Writer & Infrastructure Engineer
About the Author

Dev Patel

Senior Homelab Writer & Infrastructure Engineer

Dev Patel is a homelab builder and infrastructure writer with more than a decade of hands-on experience running self-hosted servers at home. He builds, tests, and documents real home server setups covering NAS storage, virtualization, container orchestration, and secure remote access. Dev keeps a live rack in his basement stacked with refurbished enterprise gear, and he learns most of what he writes by breaking things first and fixing them later. His guides focus on the small details that only surface after the first thousand hours of running a homelab, including power draw, thermals, disk failure patterns, and the tiny configuration choices that decide whether a weekend project becomes a five year backbone.

  • Synology
  • QNAP
  • TrueNAS
  • RAID & ZFS
  • Backup strategy

118 published guides View all articles