Home › Knowledgebase › KB-1128

How to Move Your Small Business Files from an Old File Server to SharePoint Online

Summary

This guide helps you troubleshoot and resolve: How to Move Your Small Business Files from an Old File Server to SharePoint Online. Follow the steps below to fix the issue.

Quick Tip: Need immediate assistance? 💻 Open a Ticket

Common Causes

Moving your small business files from an on-premise file server to SharePoint Online provides your team with secure, remote access to business documents from any device. This migration centralizes your data in the Microsoft 365 cloud, enabling real-time collaboration and removing the need to maintain physical server hardware in your office.

SharePoint Online is ideal for team collaboration and departmental file storage. If your staff require personal cloud storage for individual working files that are not shared with colleagues, consider OneDrive for Business instead. For most small business migrations, SharePoint document libraries provide the best balance of shared access and centralised management.

Prerequisites

Before starting your migration, ensure the following requirements are met:

Migration Steps

  1. Plan your SharePoint site and document library structure.
  2. Audit and clean up your existing file server data.
  3. Create SharePoint sites and document libraries.
  4. Install and configure the SharePoint Migration Tool.
  5. Run the initial migration and perform delta syncs.
  6. Recreate permissions manually in SharePoint.
  7. Sync libraries using the OneDrive sync client.
  8. Verify data integrity and notify users.
  9. Decommission the old file server and apply retention policies.

Detailed Instructions

1. Plan Your SharePoint Structure

Before migrating, decide how your files will be organized in SharePoint. We recommend creating a top-level site for your organization and separate document libraries for each department, such as Finance, HR, and Operations.

  1. Sign in to the SharePoint admin center at https://admin.microsoft.com/sharepoint.
  2. In the left-hand navigation, select Sites > Active sites.
  3. Click Create and choose Team site or Communication site.
  4. Enter the site name, description, and add members who require access to shared files.
  5. Inside the site, navigate to the Documents library or create new document libraries for each department.
Note: Use American spelling for Microsoft 365 product and interface terms, such as organization, center, and license, even when writing in Australian English.

2. Prepare Your File Server

Migrating unnecessary data increases migration time and clutters your cloud storage.

  1. Review your current network shares and identify files that have not been accessed in several years.
  2. Move archival data to a separate folder or external drive if it does not need to be in SharePoint.
  3. Close all files and ensure no users are actively editing documents during the migration window.
  4. Identify and exclude open database files (such as .mdb, .accdb, or .sql files) and Outlook PST files, as these cannot be migrated reliably while in use.
Critical warnings:
  • SharePoint has a maximum file path length of 400 characters. Shorten deeply nested folder names before migrating.
  • The maximum file size is 15GB per file. Split or archive any files larger than this limit.
  • SharePoint does not support certain special characters in file and folder names, including ", *, :, <, >, ?, /, \\, and |. Rename files containing these characters before migration.
  • The SharePoint Migration Tool does not automatically map NTFS permissions to SharePoint permissions. You must manually recreate access controls in SharePoint after migration.
Tip: Inform your staff of the migration date in advance to avoid data conflicts or lost changes during the transfer.

3. Install the SharePoint Migration Tool

Microsoft provides a free utility called the SharePoint Migration Tool (SPMT) designed specifically for moving file shares to SharePoint Online.

  1. Download the SharePoint Migration Tool from the official Microsoft Download Center.
  2. Install the application on a machine with a stable connection to both your file server and the internet.
  3. Launch the tool and sign in with your Microsoft 365 Global Administrator account.

4. Run the Migration

  1. Select File share as the source type.
  2. Enter the file path of your source folder (e.g., \\Server\\SharedDocs).
  3. Select the destination SharePoint site and document library you created earlier.
  4. Review the mapping and click Migrate.
  5. Monitor the progress in the SPMT dashboard. Once complete, review the migration report for any failed files.

5. Delta Migration and Incremental Sync

For large file servers, run an initial migration during a quiet period, then perform a delta migration to capture only files that changed since the first transfer. This minimises downtime during the final cutover.

  1. Run the initial full migration outside business hours.
  2. Allow staff to continue working on the file server during business hours.
  3. Run a delta migration immediately before decommissioning the old server to synchronise new and changed files.
  4. Schedule the final delta sync for a weekend or after-hours window to ensure no data is missed.
Caution: Large migrations may take several hours or days depending on your upload speed. Schedule bulk transfers outside business hours to avoid impacting daily workflows.

6. Sync SharePoint Libraries with OneDrive

To help staff adjust, you can sync SharePoint libraries to Windows File Explorer using the OneDrive sync client.

  1. Open your SharePoint document library in a web browser.
  2. Click Sync to open the OneDrive sync client.
  3. Follow the prompts to sign in and sync the library to your computer.
  4. Once synced, the SharePoint library appears in File Explorer under your organization's name.

7. Recreate Permissions and Notify Users

After migration, confirm that staff can access the files they need. Remember that NTFS permissions are not carried over automatically.

  1. In SharePoint, select the document library and click Settings > Library settings.
  2. Choose Permissions for this document library and stop inheriting permissions from the parent site if unique access controls are required.
  3. Grant Read, Edit, or Full Control permissions to the appropriate Microsoft 365 groups or individual users.
  4. Ask department heads to verify their teams can open, edit, and save documents.
  5. Provide staff with a short guide on accessing SharePoint via the web browser and the OneDrive sync client.

8. Post-Migration Decommissioning and Retention

  1. Keep the old file server online in read-only mode for at least 14 days as a rollback fallback.
  2. Compare critical folders between the source server and SharePoint to verify data integrity.
  3. Apply SharePoint retention policies or labels to document libraries to meet your business compliance requirements.
  4. Once you are confident the migration is complete, decommission the old file server hardware or repurpose it for other workloads.
Rollback plan: If migration fails or critical data is missing, do not wipe the old file server. Keep it available as a read-only source until you have verified all files in SharePoint and user access is restored.

Troubleshooting

Migration fails due to file path length

SharePoint has stricter limits on file path lengths than traditional Windows file servers.

Unsupported file name characters

SPMT may skip files containing characters not supported by SharePoint.

File size limit exceeded

SharePoint Online supports a maximum file size of 15GB per file.

Common SPMT error codes

Permission errors during transfer

If the migration tool cannot access certain folders, it may be due to NTFS permissions on the source server.

Files not syncing after migration

If files appear in SharePoint but not in the local sync client:

If you encounter issues that cannot be resolved using these steps, Open a Ticket.

Still Having Issues?

Need more help? If the issue persists after trying these steps, please open a support ticket and our team will assist you.

💻 Open a Ticket