What does "per-run capacity" mean?

Each plan defines the maximum total size of source data that can be included in a single sync run. For example, if you have a 10 TB plan, you can migrate any bucket up to 10 TB in one run. If your bucket is 3 TB, the entire 3 TB is included in the plan. The limit resets for every new run.

Does the limit reset every run?

Yes. The capacity limit applies per run and is not cumulative. If you have a 10 TB plan, you can run unlimited migrations of up to 10 TB each — including retries and resumes.

Can I run multiple migrations at the same time?

Yes. You can run multiple migrations concurrently. Each run simply needs to fit within your plan's per-run capacity.

How is the run size calculated?

The total size is calculated from all discovered source objects during the planning phase. Objects are counted based on their source size, even if they already exist at the destination.

What happens if my bucket exceeds my plan's capacity?

During planning, files are scheduled until the next file would exceed your plan’s capacity. That file and all subsequent files are excluded from the run. You can then upgrade your plan or split the migration into smaller runs.

Can I upgrade my plan?

Yes. You can purchase a higher-capacity license at any time.

What’s the difference between the Free plan and the 50 GB trial?

The Free plan includes a permanent 10 GB per-run capacity with no expiration. The 50 GB trial is a 30-day license available after registration, allowing you to evaluate larger migrations before purchasing.

Does retrying or resuming a migration consume extra capacity?

No. Each run is evaluated independently. As long as the total source size fits within your plan’s per-run capacity, you can retry or resume without penalty.

Do you charge for bandwidth or transferred bytes?

No. Godwit Sync is licensed based on per-run capacity, not on transferred bandwidth.

What S3-compatible providers are supported?

Godwit Sync works with any S3-compatible storage, including AWS S3, MinIO, Cloudflare R2, Backblaze B2, DigitalOcean Spaces, Wasabi, and self-hosted object storage.

Do I need a license for --plan-only mode?

Yes. Capacity is evaluated during the planning phase. The same per-run limit applies whether you run --plan-only or execute the migration.

Is my data processed through your servers?

No. Godwit Sync runs locally in your environment. Data flows directly between source and destination. Nothing passes through our infrastructure.

Does the license work offline?

Yes. The license is a signed file that is validated locally and does not require continuous internet access.

What payment methods do you accept?

We accept all major credit and debit cards via Stripe.

Швидкий старт

Почніть роботу з Godwit Sync

Швидка, надійна та передбачувана синхронізація даних — для команд, які покладаються на S3 кожного дня. Почніть за лічені хвилини.

Що таке Godwit Sync?

Godwit Sync — це високопродуктивна утиліта передачі S3, що підтримує кілька режимів передачі:

S3 → Локальна файлова система
Локальна файлова система → S3
S3 → S3 (повністю на льоту, без локального сховища)

Вона спочатку створює детермінований план синхронізації (або тільки створює план з --plan-only), підтримує безпечне переривання та продовження через --resume, та дає вам точний контроль над пропускною здатністю через --rps та --read-bps.

Крок 1: Встановлення

Завантажте останній реліз для вашої платформи та розпакуйте бінарний файл:

# Download for Linux (x86_64)
curl -LO https://downloads.godwit.io/godwit-sync/latest/godwit-sync_linux_amd64.tar.gz

# Or for ARM64
curl -LO https://downloads.godwit.io/godwit-sync/latest/godwit-sync_linux_arm64.tar.gz

# Extract the archive
tar -xzf godwit-sync_linux_*.tar.gz

# Move to PATH
sudo mv godwit /usr/local/bin/godwit

# Verify installation
godwit version

# Download using PowerShell
Invoke-WebRequest -Uri "https://downloads.godwit.io/godwit-sync/latest/godwit-sync_windows_amd64.zip" -OutFile "godwit-sync.zip"

# Extract the archive
Expand-Archive -Path godwit-sync.zip -DestinationPath .

# Move to a directory in your PATH (e.g., C:\Program Files\godwit)
New-Item -ItemType Directory -Force -Path "C:\Program Files\godwit"
Move-Item godwit.exe "C:\Program Files\godwit\godwit.exe"

# Add to PATH (run as Administrator)
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\Program Files\godwit", "Machine")

# Verify installation (restart terminal first)
godwit version

# Download for macOS (Intel)
curl -LO https://downloads.godwit.io/godwit-sync/latest/godwit-sync_darwin_amd64.tar.gz

# Or for Apple Silicon (M1/M2/M3)
curl -LO https://downloads.godwit.io/godwit-sync/latest/godwit-sync_darwin_arm64.tar.gz

# Extract the archive
tar -xzf godwit-sync_darwin_*.tar.gz

# Move to PATH
sudo mv godwit /usr/local/bin/godwit

# Verify installation
godwit version

# Download for FreeBSD (x86_64)
fetch https://downloads.godwit.io/godwit-sync/latest/godwit-sync_freebsd_amd64.tar.gz

# Extract the archive
tar -xzf godwit-sync_freebsd_*.tar.gz

# Move to PATH
sudo mv godwit /usr/local/bin/godwit

# Verify installation
godwit version

# Multi-arch tags include both linux/amd64 and linux/arm64.
# Docker will automatically pull the correct image for your machine.
IMAGE="godwitio/godwit-sync:latest"
# IMAGE="godwitio/godwit-sync:v1.0.1"  # specific version (also multi-arch)

# Pull the image
docker pull "$IMAGE"

# Run godwit sync via Docker
docker run --rm -v $(pwd)/data:/data -v $(pwd)/state:/state "$IMAGE" sync \
  --source /data \
  --destination s3://my-bucket/backup \
  --destination-endpoint localhost:9000 \
  --destination-access-key s3key \
  --destination-secret-key s3secret \
  --state-path /state/state.db

# Verify installation
docker run --rm "$IMAGE" version

Переглянути всі доступні теги на Docker Hub

Крок 2: Ліцензування

Godwit Sync пропонує безкоштовний режим для оцінки та платні ліцензії для продакшен використання:

Безкоштовний режим

Планування міграцій до 10GB. Ідеально для тестування та невеликих передач.

Ліцензований режим

До 10TB даних. Повний доступ до функцій. Комерційне використання. Зв'яжіться з нами, якщо потрібно більше.

# Register a license (saves beside the executable)
godwit sync --register <base64-license-key>

# Or provide license file per-run
godwit sync --license-file ./license.json ...

# Or provide inline base64 license
godwit sync --license <base64-string> ...

Крок 3: Ваша перша синхронізація

Почніть з простої синхронізації локальної папки до S3:

godwit sync \
  --source ./data \
  --destination s3://my-bucket/backup \
  --destination-endpoint localhost:9000 \
  --destination-access-key access_key \
  --destination-secret-key secret_key \
  --destination-secure=false \
  --state-path ./tmp/state.db \
  --logs-dir ./tmp/logs \
  --ui

Спочатку план

Використовуйте --plan-only, щоб побачити, що буде передано, перш ніж переміщувати дані:

# Create a plan without executing
godwit sync \
  --source ./data \
  --destination s3://my-bucket/backup \
  --destination-endpoint localhost:9000 \
  --destination-access-key access_key \
  --destination-secret-key secret_key \
  --destination-secure=false \
  --state-path ./tmp/state.db \
  --plan-only

# Review, then execute with resume
godwit sync \
  --source ./data \
  --destination s3://my-bucket/backup \
  --destination-endpoint localhost:9000 \
  --destination-access-key access_key \
  --destination-secret-key secret_key \
  --destination-secure=false \
  --state-path ./tmp/state.db \
  --resume

Крок 4: Увімкніть спостережуваність

Додайте --status-addr для надання endpoints метрик та статусу:

godwit sync \
  --source ./data \
  --destination s3://my-bucket/backup \
  --destination-endpoint localhost:9000 \
  --destination-access-key access_key \
  --destination-secret-key secret_key \
  --destination-secure=false \
  --status-addr :8080

Це надає:

/metrics— Prometheus-формат метрик (лічильники, гістограми, ETA)
/status— JSON підсумок поточного запуску

Наступні кроки

Довідник CLI

Дослідіть усі прапорці та параметри конфігурації.

Переглянути довідник CLI

Посібники

Покрокові посібники для типових сценаріїв.

Переглянути посібники