
An SMB connection can fail on a Mac because the server is offline, the address is incorrect, your account lacks permission, saved credentials are outdated, or the network is blocking file sharing. Start by confirming the server and network are working, then reconnect using the correct SMB address. If that does not help, remove outdated credentials from Keychain Access, check sharing settings, and test the connection with a different account or device.
Quick Answer
- Make sure your Mac and the file server, PC, or NAS are connected to the same network. 2. Verify the server’s name or IP address. 3. In Finder, choose Go > Connect to Server, enter
smb://server-name/share-name, and select Connect. 4. Choose Registered User and enter the correct username and password. 5.
Check the Basic Connection First
Before changing settings on your Mac, determine whether the problem is limited to one device or affects the entire network.
Confirm both devices are online
Check that your Mac and the server are connected to the same local network. A Mac connected to a guest Wi-Fi network may be unable to reach devices on the main network. VPN software can also route traffic away from your local network.
Temporarily disconnect from a VPN, if appropriate, and try again. If the server is a NAS or another computer, confirm that it is powered on and connected to the network.
If other devices cannot connect to the same shared folder, the problem is probably on the server or network rather than on your Mac.
Test the server’s address
An SMB connection can fail if the server name is misspelled or no longer resolves correctly. If possible, obtain the server’s current IP address from the device’s network settings or router.
For example, an SMB address may look like either of these:
smb://Office-PC/SharedFiles
smb://192.168.1.25/SharedFiles
The first uses the server’s network name. The second connects directly to its IP address. If the name does not work, try the IP address. If the IP address works but the name does not, your network may have a name-resolution problem.
Reconnect to the Shared Folder in Finder
Finder is usually the simplest way to establish an SMB connection.
- Open Finder.
- Choose Go > Connect to Server from the menu bar.
- Enter the server address, including the
smb://prefix. Include the shared folder name if you know it. - Select Connect.
- If macOS asks for an account, select Registered User.
- Enter the username and password assigned to the server.
- Select Connect again.
- If macOS displays a list of shared folders, choose the one you need and select OK.
If you regularly use this server, select the plus button next to the server address to add it to your favorite servers. Be careful when saving passwords. On a shared Mac, do not save credentials if other people can access your user account.
For more detailed connection examples, see How to Connect to a Shared Folder or NAS on a Mac.
Use the correct username format
Some servers require a username in a particular format. Depending on the server, try one of these forms:
username
SERVER-NAME\username
username@domain
Do not guess repeatedly if the account may become locked after failed attempts. Check the server’s account settings or ask the administrator which username format to use.
If the shared folder is on another Mac, use an account that exists on that Mac and has permission to access the shared folder. The password for your current Mac account may not be the correct password for the remote computer.
Remove an Outdated Saved Password
macOS may continue using an incorrect password saved for the server. Removing that entry lets you authenticate again with current credentials.
Warning: The following step deletes a saved credential from your Mac’s keychain. It does not delete files from the server, but you will need to enter the password again.
- Open Keychain Access. You can find it in Applications > Utilities or by using Spotlight.
- In the search field, enter the server name, IP address, or part of the shared folder name.
- Look for an internet password or network password associated with the SMB server.
- Select the relevant entry.
- Press Delete, or choose Edit > Delete.
- Confirm the deletion if macOS asks.
- Return to Finder and connect to the SMB server again.
- Enter the correct credentials when prompted.
If several entries appear, remove only the ones clearly associated with the problem server. Avoid deleting unrelated passwords.
Check Permissions on the Shared Folder
A successful network connection does not automatically grant access to every folder. The account used for SMB must have permission on both the server and the shared folder.
On a Mac hosting the folder:
- Open System Settings.
- Select General, then Sharing.
- Make sure File Sharing is enabled.
- Review the list of shared folders.
- Select the relevant folder and check the Users section.
- Confirm that your account, or an appropriate group, has access.
The available permissions may include read-only or read-and-write access. If the account is not listed, add it using the add button and assign the appropriate permission.
On a Windows computer, confirm that the account has both share-level permission and file-system permission. A user can be allowed to connect to a share but still be denied access to the folder itself.
On a NAS, check the device’s administration page for:
- The user account and password
- Shared-folder permissions
- SMB service status
- Access restrictions
- Whether the share is enabled
If macOS reports “Permission denied” after connecting, the issue is likely authorization rather than network discovery. See How to Fix Permission Denied Errors on a Shared Folder on a Mac for permission-specific checks.
Make Sure SMB Is Enabled on the Server
The client and server must have a compatible file-sharing service. On the server, verify that SMB is enabled and that the specific shared folder is published.
Some devices also offer older protocols, such as AFP or FTP. Do not switch to an older protocol simply because SMB fails unless you understand the security and compatibility consequences. SMB is generally the appropriate protocol for current Mac-to-PC and Mac-to-NAS file sharing.
If the server recently received a software update, its SMB settings may have changed. Review settings related to:
- SMB file sharing
- Guest access
- Minimum and maximum SMB protocol versions
- Local users
- Network access control
- Firewall rules
If you do not administer the server, ask its owner or administrator to verify these settings.
Check macOS and Server Firewall Settings
A firewall can allow internet access while blocking local file-sharing traffic. Review the firewall on the server and any network security equipment between the Mac and server.
On a Mac hosting files:
- Open System Settings.
- Select Network.
- Select Firewall.
- Review whether the firewall is enabled and whether file-sharing services are allowed.
The exact options can vary depending on the system configuration. Avoid disabling a firewall permanently just to test SMB. If you temporarily change a security setting, restore it immediately after testing.
Some office, hotel, school, and guest networks intentionally block device-to-device communication. In that situation, SMB may not work even when both devices appear to have internet access. Use a trusted local network or contact the network administrator.
Disconnect a Stuck SMB Session
A previous connection can remain mounted even when Finder appears to have stopped responding. Disconnect the share before trying again.
- In Finder, look under Locations in the sidebar.
- Select the connected server or shared folder.
- Select the eject button next to it.
- Wait a moment, then reconnect through Go > Connect to Server.
If the server does not appear in Finder, restart the Mac and try again. Restarting can close a stalled network session, but save your work first because open applications may not preserve unsaved changes.
You can also eject a mounted share by selecting it on the desktop or in Finder and choosing File > Eject.
Try the Server’s IP Address
Network names can fail while direct IP connections continue to work. To test this:
- Find the server’s current local IP address.
- Open Finder.
- Choose Go > Connect to Server.
- Enter an address such as:
smb://192.168.1.25/SharedFiles
- Select Connect and enter your credentials.
If this works, the SMB service and permissions are probably functioning. The remaining problem may involve DNS, NetBIOS name resolution, a changed server name, or a router that does not reliably advertise local devices.
An IP address can change when the server reconnects to the network. For a long-term solution, configure a reserved address on the router or use a reliable local hostname, if you administer the network.
Use Terminal to Test Network Reachability
Terminal can help determine whether your Mac can reach the server at all. These commands only test connectivity; they do not change files or network settings.
Open Terminal from Applications > Utilities, then run:
ping -c 4 192.168.1.25
Replace the address with the server’s IP address. The command sends four network tests and reports whether the server responds. Stop testing if the address belongs to a device you do not recognize.
You can also test whether the SMB service is accepting connections on its standard port:
nc -vz 192.168.1.25 445
Port 445 is commonly used for SMB. A successful result indicates that the Mac can reach an SMB service at that address. It does not prove that your username, password, or folder permissions are correct.
These commands make no persistent changes, so there is no reversal step. If ping fails, focus on the network, server power, Wi-Fi isolation, VPN, or firewall. If port 445 fails while the server is online, investigate the server’s SMB service and firewall.
Troubleshooting Common SMB Error Messages
“There was a problem connecting to the server”
Verify the address and try the server’s IP address. Then confirm that SMB is enabled and the server is on the same network. Restarting the server and Mac may clear a temporary service or network problem.
“Connection failed” or repeated password prompts
Remove the server’s saved password from Keychain Access and reconnect. Check the username format and confirm that the account is active on the server. If another user can connect with the same account, the problem may be a stale credential stored on your Mac.
“You do not have permission to access this server”
Ask the server administrator to confirm both the account permission and the shared-folder permission. On a Mac server, review System Settings > General > Sharing > File Sharing. On a NAS or Windows PC, check the corresponding share and folder permissions.
The server appears in Finder but will not open
Discovery only means that macOS found the device. It does not guarantee that the SMB service is available or that your account is authorized. Connect manually using Go > Connect to Server and specify the SMB address.
Files open slowly or transfers stop
Weak Wi-Fi, VPN routing, sleep settings, overloaded NAS hardware, and large files can all affect transfers. Test with a wired connection if possible, move closer to the wireless access point, and temporarily disconnect from a VPN. Do not interrupt a transfer if doing so could leave a partially copied file; verify the destination before trying again.
When to Restart or Reset Settings
Restart the Mac and server after saving your work if the connection remains stuck. This is safe for stored files but can close applications and interrupt active transfers.
Avoid deleting system configuration files or changing advanced SMB protocol settings unless you administer the server and have a backup plan. An incorrect protocol or security change can affect every user who connects to that server.
If the problem began after changing the Mac’s network configuration, review System Settings > Network and confirm that the correct Wi-Fi or Ethernet service is connected. Make only one change at a time so you can identify what resolves the problem.
For Mac-to-Mac file transfers, How to Share Files Between Two Macs covers the sharing setup from the host side.
Frequently Asked Questions
Why does my Mac see the SMB server but fail to connect?
Finder may discover a device without being able to authenticate or open its shares.
Can I connect to SMB with an IP address?
Yes. In Finder, choose Go > Connect to Server and enter an address such as smb://192.168.1.25/ShareName.
Why does SMB keep asking for my password?
The saved password may be outdated, or the username format may be incorrect.
Does a VPN prevent SMB connections?
A VPN can interfere with local SMB access by changing routing or blocking local-network traffic. Disconnect from the VPN temporarily to test.
Is SMB the same as screen sharing?
No. SMB provides access to shared files and folders. Screen sharing lets you view or control another Mac’s desktop.
Final Thoughts
Most SMB connection failures on a Mac come down to an incorrect server address, unavailable SMB service, blocked network traffic, outdated credentials, or missing folder permissions.