Sync large folders
The first sync of a big library is the one that matters. This guide shows how to get a multi-terabyte folder to the cloud in the least time and keep your computer usable while it happens.
Before you start
- Make sure your plan has room. A folder of 3.2 TB needs at least Greenhouse (6 TB). The plan finder estimates upload time for your line speed.
- Check the largest file. Porch accepts files up to 100 GB, Greenhouse 250 GB and Atrium 1 TB.
- Use a wired connection for the first upload if you can. The client works on Wi-Fi, but a cable removes the most common cause of pauses.
Add the folder
Open the Sunroom menu, choose Add folder to sync and pick the folder. The client scans it once. On a spinning disk, expect about 90 seconds per million files. After the scan it switches to listening for changes, which uses almost no CPU.
Tip. Do not move the folder while the first scan runs. If you must, pause syncing first, move it, then use Relink folder so the client does not treat the move as a delete and a new upload.
Choose what stays on disk
Right-click a folder in Finder or Explorer and pick one of three states:
- Always on this device: files are kept offline and updated.
- Online-only: files appear as placeholders and download when you open them.
- Not synced: the folder is hidden on this computer and nothing is downloaded.
A laptop with 512 GB of disk can browse a 20 TB drive this way. Only what you open takes space, and the cache is trimmed when free disk falls below 10%.
Tune the upload
In Settings, Sync you can set the number of parallel connections (2 to 8 depending on plan), an upload limit, and a quiet-hours schedule. A good starting point on a 500 Mbit/s line is 6 connections and no limit overnight, 40 Mbit/s during the working day.
Settings, Sync
Parallel connections 6
Upload limit 40 Mbit/s (09:00-18:00 Mon-Fri)
Block size 4 MB (read only)
Chunk size 64 MB (read only)
What happens when the connection drops
Each chunk is verified with a SHA-256 hash before it counts as uploaded. After an interruption the client asks the server which chunks it already has and sends only the rest. A 38 GB file that failed at 91% resumes at 91%, even after a reboot.
If sync looks stuck
- Open the menu and read the status line. “Waiting for 3 files” usually means the files are locked by another app.
- Choose Help, Show sync log and look for the last red line.
- Names with a trailing space or a character not allowed on the other system are listed under Needs attention. Rename them and sync continues.
Still stuck? Send the log from Help, Send diagnostics to support. It contains file names and error codes, never file contents.