Agent Config (Windows) | XMigrate Docs

This is a Windows agent example. Save it as C:\ProgramData\xreplicator\agent.yaml and run the agent as Administrator.

daemon.pipeline.fixed_block_size_mb must match the server’s server.fixed_block_size_mb.

For large-disk tuning guidance (chunk size, workers, batch size, and memory-safe profiles), see Daemon Mode.

After editing the config, restart the service:


Restart-Service XReplicatorAgent


device:
  paths:
    - "F:"
 
storage:
  type: "grpc"
  grpc:
    server_address: "YOUR_SERVER_IP:50051"
    timeout: 5m
    max_retries: 3
    tls:
      enabled: false
 
ebpf:
  enabled: false
  block_size_kb: 64
  dirty_block_min_age: 60s
  fallback_on_error: true
  bitmap_persist_path: "C:\\ProgramData\\xreplicator\\bitmap.db"
  state_persist_path: "C:\\ProgramData\\xreplicator\\tracking_state.json"
  heartbeat_interval: 30s
  max_tracking_gap: 5m
  recovery:
    on_interruption: "full_incremental"
    verify_on_startup: true
    log_recovery_details: true
  block_group_aware: true
  block_group_detection: "auto"
  block_group_sync_strategy: "full"
 
daemon:
  compression:
    enabled: true
    level: 1
  pipeline:
    fixed_block_size_mb: 8
    workers: 4
    batch_size: 100
 
windows:
  usn:
    enabled: true
    block_size_kb: 64
    state_persist_path: "C:\\ProgramData\\xreplicator\\usn_state.json"
    fallback_on_error: true
    auto_create: true
    journal_max_mb: 32
    journal_alloc_mb: 16
    full_scan: true
 
schedule:
  full_backup:
    enabled: true
    frequency: "weekly"
    day_of_week: "sunday"
    time: "02:00"
 
  incremental_backup:
    enabled: true
    frequency: "custom"
    interval: "1h"
    skip_if_no_changes: true