Rsync — the tool I wish someone had told me about earlier

I was deep into a project, trying to keep files in sync between my local machine and a remote dev server. My workflow was embarrassing zip the folder, scp the whole thing over, unzip, repeat.

Every time. Even if I changed one line.

It worked. But it was slow, clunky, and felt wrong in a way I couldn't articulate yet.

Then someone in a thread casually dropped rsync like it was obvious. It wasn't obvious to me. I ran the command once, it transferred only the files that actually changed, over SSH, in seconds, and I felt genuinely stupid for not knowing about it sooner.

This is the guide I wish had existed then.

What rsync actually does differently

You've got a config file on your laptop and an identical one on your production server. You tweak just one line locally to fix a bug. Now you need that server copy updated to match, without uploading the entire 5MB file over a slow connection.

Rsync smartly detects the tiny difference and transmits only that change, keeping everything in sync efficiently.

Think of scp as photocopying an entire book every time one page changes. rsync reads both copies, finds only the changed pages, and sends just those. It uses a delta-transfer algorithm- before transferring, it compares the source and destination by checking modification times and file sizes, then sends only the changed portions. digitalocean On a large project, that difference is felt immediately.

The command you'll use 90% of the time

rsync -avz dir1/ user@remote_host:~/destination/

Breaking it down simply:

-a — archive mode. Syncs recursively and preserves permissions, timestamps, and ownership. Always use this over -r.

-v — verbose. Shows you what's happening.

-z — compresses data during transfer. Useful over slow connections. The trailing slash matters more than you think.

The trailing slash matters more than you think.

rsync -a dir1/ dir2    # copies contents of dir1 INTO dir2
rsync -a dir1 dir2     # copies dir1 itself INTO dir2 → dir2/dir1/

This one trips everyone up at least once. The slash says "copy what's inside" — no slash says "copy the folder itself."

Before you run anything — dry run first

rsync --dry-run -avz dir1/ dir2

The -n or --dry-run flag simulates the entire sync without making any actual changes — showing you exactly which files would be copied, updated, or deleted.

By default, rsync never deletes. If you remove a file from the source, it stays in the destination.

To properly use this:

rsync -avz --delete dir1/ user@remote_host:~/destination/

Always dry run this one first. --delete is permanent.