ReplaceMagic System Requirements — Windows, RAM, CPU and .NET
ReplaceMagic is a multi-threaded application — it processes multiple documents simultaneously in memory. The more CPU cores and RAM you have, the faster it processes large document libraries. Below are the hardware and software requirements to get the best results.
Hardware Requirements
| Component | Recommended | Minimum |
|---|---|---|
| CPU | 64-bit quad-core processor or better | 64-bit dual-core 1.4 GHz processor |
| RAM | 16 GB or more | 8 GB (expect slower performance) |
| Storage | 500 MB for installation + space for logs and document backups | 500 MB for installation + log space |
| Operating System | Windows 10, 11, Windows Server 2016/2019/2022 | Any Windows version supporting .NET Framework 4.8 |
| Network | High-speed connection to document storage and SharePoint | Network access to target document location |
Software Requirements
Required
- .NET Framework 4.8 or later
- Windows OS (32-bit or 64-bit)
- Network access to the document storage being scanned
Not Required
- Microsoft Office does not need to be installed
- No internet connection required for local/network processing
- No server-side installation needed — desktop app only
Supported Microsoft Office Versions
ReplaceMagic processes Office file formats directly without requiring Office to be installed. The following versions are supported:
- Microsoft Office 2000, 2003, 2007
- Microsoft Office 2010, 2013
- Microsoft Office 2016, 2019
- Microsoft Office 2021
- Microsoft 365 (Office 365) — all current formats supported
Full feature support for Office 2000–2019. Office 2021–2024 and Microsoft 365 formats are fully compatible. If you encounter a specific format issue, send us the document and we will investigate.
How Much RAM Do You Need?
ReplaceMagic processes documents completely in memory — it reads the entire document, makes changes in RAM, then writes the result back to disk. This makes it fast but means RAM is the primary bottleneck for large document libraries.
RAM Calculation Formula
Parallel threads × Maximum document size (MB) × 10 = Minimum RAM needed (MB)
Example: 8 parallel threads × 100 MB maximum document size × 10 = 8,000 MB (8 GB) RAM needed
Practical guidelines:
- Small documents (under 10 MB each): 8 GB RAM is sufficient for most scenarios
- Medium documents (10–50 MB each): 16 GB RAM recommended with 8 parallel threads
- Large documents (50–100 MB each): 16–32 GB RAM recommended; reduce parallel threads if needed
- Very large documents (100+ MB): Increase RAM or reduce parallel processing threads; consider splitting large files before processing
CPU and Parallel Processing
ReplaceMagic distributes document processing across CPU cores — each document is processed on a separate thread. More cores = more documents processed simultaneously = faster overall throughput.
2–4 cores
Suitable for small migrations or testing. Set parallel processing to 2–4 in Configuration.
4–8 cores
Good for medium-sized migrations. Set parallel processing to 4–8 depending on available RAM.
8+ cores
Ideal for large enterprise migrations. Set parallel processing to match core count minus 1–2 for OS overhead.
Additional Requirements for SharePoint
When using ReplaceMagic's native SharePoint integration, the following additional requirements apply:
- Network connectivity: The machine running ReplaceMagic must have HTTPS access to SharePoint Online (port 443) or network access to the SharePoint on-premises server
- SharePoint permissions: Read/Write access to the document libraries being processed; Site Administrator rights are required to preserve last-modified date and author metadata
- SharePoint Online throttling: Limit parallel processing to 3–5 threads for SharePoint Online to avoid HTTP 429 throttling errors. Enable “Decrease workload during SharePoint Throttling” in Configuration for automatic management
- Authentication: Credentials for the chosen authentication mode (SharePoint Online, Windows, MFA app password, App-Only certificate)
- Proxy/firewall: If a corporate proxy is in use, configure it in Configuration → Processing tab so ReplaceMagic can reach SharePoint Online
Storage Considerations for Large Migrations
For large migration projects, plan storage for:
- Logs: Detailed processing logs can grow significantly for large runs — allow 1–5 GB on log volume
- Document backups: If you enable the backup option, ReplaceMagic copies each modified document before changing it. For 100,000 documents averaging 5 MB each, allow ~500 GB of backup space
- Scan exports: CSV or database exports of scan results are typically small (a few hundred MB for millions of links)
Performance Tips
- Run ReplaceMagic on the same network segment as the document storage — latency between ReplaceMagic and the file server/SharePoint directly impacts throughput
- Use a dedicated machine for large migration runs rather than a shared workstation — other applications competing for RAM and CPU will slow processing
- For overnight migrations, close unnecessary applications and set Windows power settings to “High performance” to prevent sleep
- Enable the “Optimize workload” option in Configuration → Configuration tab — ReplaceMagic will automatically tune parallel processing to your hardware
- For SharePoint Online processing, run during off-peak hours (nights/weekends) when Microsoft’s throttling limits are less likely to be triggered
























