Sync client configuration

The client reads ~/.config/bebra/config.toml. All settings can also be managed from the tray menu; the file is authoritative on restart.

[sync]
folder = "~/Bebra"
selective = ["Projects/2026", "Shared/Design"]
bandwidth_up_mbps = 0      # 0 = unlimited
bandwidth_down_mbps = 0

[lan]
peer_sync = true           # exchange blocks with devices on the same LAN
port = 21027

[advanced]
chunk_size = "auto"
max_parallel_transfers = 8
ignore = ["*.tmp", ".DS_Store", "node_modules"]

Selective sync

List the top-level folders you want materialized locally. Everything else stays in the cloud as an on-demand placeholder (0 bytes on disk) until opened.

Headless mode

For servers and NAS devices, run bebra-sync --headless --config /etc/bebra/config.toml. Authentication uses a device token created in the dashboard under Devices → Add headless device.

Conflict handling

When two devices edit the same file offline, the client keeps both versions: the winner keeps the name, the other becomes filename (conflict 2026-04-12).ext. Conflicts are listed in the tray menu and in the web client.

Next: REST API →