File Sync

Last updated 2026-10-06

This page explains how podrun up syncs the local project to the remote host with rsync, including the diff preview before overwriting.

Flow

graph TB
    Start[RsyncToRemote] --> Check{Remote folder empty?}
    Check -->|empty| Sync[rsync -avz --delete]
    Check -->|not empty| Preview[rsync -avni --delete<br/>dry-run]
    Preview --> Changed{Changes?}
    Changed -->|no| Sync
    Changed -->|yes| Ask[Prompt confirm sync? y/N]
    Ask -->|y / Y| Sync
    Ask -->|other| Cancel[Return cancelled]

Diff Preview

When the remote folder already has content, rsync -avni --delete runs first and its output is printed. These lines count as "no change" and are skipped:

Any other line counts as a change and requires y or Y to continue; any other input returns cancelled and aborts up. A confirmed overwrite writes an overwrite record; an empty remote folder writes a sync record.

Sync

The real sync uses rsync -avz --delete, so extra remote files are deleted and the remote folder mirrors the local one.

Exclude List

The diff preview also excludes docker-compose.podrun.yml so the remote copy is not reported as a change; the real sync does not exclude it, so --delete removes the remote copy and Compose Rewrite regenerates it afterward.

.env is not excluded and is synced to the remote host.

SSH Behavior