UniFi Drive - Add UniFi Drive to Your Desktop via SMB

SMB (Server Message Block) is a network protocol that allows you to share files and resources across connected devices. It can also be used to access UniFi Drive content without opening the web application.

Requirements

• SMB connectivity must be enabled in UniFi Drive. This can be done in UniFi Drive > Settings > Services.
• Your desktop and UniFi NAS must be connected to the same network.

Setting Up File Service Credentials

Currently, users can add File Service Credentials only after creating a user. To do this:

1. Go to Control Plane > Users.
2. Select a user, then click on the Settings tab in the side panel.
3. Locate File Service Credentials and complete the setup there.

Note: This temporary setup instruction will remain until the option to add File Service Credentials during user creation is restored.

Sync UniFi Drive with a Mac Desktop

1. Open Finder.
2. Select Connect to Server from the Go menu in the Finder taskbar.
3. In the Server Address field, enter the Samba share path using the format:

   smb://<UniFi NAS IP address>

   1. Note: This address can be found in Settings > Services in the UniFi Drive application.
4. Click the + icon to add the UniFi NAS to your Favorites list. This will make it easily accessible in Finder once connected.
5. Click Connect to sync the UniFi Drive application with your Mac.
6. Enter your File Service Credentials in the following user selection prompt.
7. Choose the drive(s) you’d like to sync with your Mac. They will appear in the Locations section of the Finder window.

Sync UniFi Drive with a Windows Desktop

1. If you have not yet done so, navigate to Drives and click the Add button in the upper right corner. The specified Drive Name will be used later.
2. Open File Explorer and right-click This PC on the left-hand side.
3. Click Map Network Drive at the top of the window.
4. Assign a letter to your UniFi Drive by selecting it from the Drive drop-down menu.
5. In the Folder field, enter the SMB share path using the format:

   \\<UniFi NAS IP address>\<Drive name>

   • The IP address can be found in Settings > Services in the UniFi Drive application. 
   • Ensure the correct type of slash is used (e.g., use '\' instead of '/').
6. Check the box labeled Connect using different credentials and enter your File Service Credentials, then click Finish.

Re-sync UniFi Drive with Your Desktop

If a UniFi Drive is renamed, deactivated, or reactivated, it must be re-synced to become accessible again. Follow these steps to restore the connection:

Mac OS

1. Restart your computer.
2. Disconnect from and reconnect to the local network.
3. Manually unmount the drive in Terminal:

   diskutil umount -f /Volumes/[SHARED_DRIVE_NAME]

   (Replace [SHARED_DRIVE_NAME] with the drive’s actual name.)
4. Follow the original sync steps to reconnect to UniFi Drive.

Windows

1. Open File Explorer and select This PC.
2. In the Network Locations section, right-click the UniFi Drive and select Disconnect.
3. Follow the original sync steps to reconnect to UniFi Drive.