# syncthing | The Syncthing Project | Knowledge Base | Instagit

Open Source Continuous File Synchronization

GitHub Stars: 80.4k

Repository: https://github.com/syncthing/syncthing

---

## Articles

### [How Syncthing's Auto-Upgrade Mechanism Works: Implementation Guide and Security Architecture](/syncthing/syncthing/describe-the-auto-upgrade-mechanism-in-syncthing-and-its-implementation-details)

Learn how Syncthing's auto-upgrade mechanism works. Discover its implementation and security architecture for seamless, verified binary replacement.

- Tags: internals
- Published: 2026-02-28

### [How Syncthing Optimizes Synchronization of Large Files and Numerous Small Files](/syncthing/syncthing/what-strategies-does-syncthing-employ-for-optimizing-synchronization-of-large-files-or-numerous-small-files)

Discover how Syncthing optimizes synchronization of large and small files with adaptive block sizing, batched indexing, parallel scanning, and selective compression. Boost your sync speed today.

- Tags: deep-dive
- Published: 2026-02-28

### [How to Interact with Syncthing’s GUI API: Complete Endpoint Guide](/syncthing/syncthing/how-can-developers-interact-with-syncthing-using-its-gui-api-and-what-are-the-common-endpoints)

Learn how to interact with Syncthing's GUI API using authenticated HTTP requests and discover essential REST endpoints. Master Syncthing integration with this complete guide for developers.

- Tags: api-reference
- Published: 2026-02-28

### [Syncthing File System Watching Mechanisms: inotify, FSEvents, and ReadDirectoryChangesW Explained](/syncthing/syncthing/what-are-the-underlying-file-system-watching-mechanisms-inotify-fsevents-etc-used-by-syncthing)

Discover how Syncthing uses inotify, FSEvents, and ReadDirectoryChangesW to efficiently watch file system changes across Linux, macOS, and Windows. Understand the core mechanisms.

- Tags: internals
- Published: 2026-02-28

### [How Syncthing Preserves and Manages File Permissions and Ownership Across Different Operating Systems](/syncthing/syncthing/how-does-syncthing-preserve-and-manage-file-permissions-and-ownership-across-different-operating-systems)

Learn how Syncthing preserves file permissions and ownership across operating systems. Discover its unified interface, metadata capture, and cross-platform application.

- Tags: internals
- Published: 2026-02-28

### [Syncthing Performance Tuning: Bandwidth and Resource Configuration Options](/syncthing/syncthing/what-are-the-key-performance-tuning-options-within-syncthing-for-bandwidth-and-resource-utilization)

Optimize Syncthing performance by fine-tuning bandwidth, connection limits, folder concurrency, and memory usage. Discover key configuration options to enhance resource utilization for your sync operations.

- Tags: performance
- Published: 2026-02-28

### [How Syncthing Handles Symbolic Links, Hard Links, and Special Files](/syncthing/syncthing/how-does-syncthing-handle-symbolic-links-hard-links-and-other-file-system-special-entries)

Discover how Syncthing handles symbolic links, hard links, and special files across platforms. Learn about its unique approach to file system variations.

- Tags: internals
- Published: 2026-02-28

### [How Syncthing’s Model Package Manages Core Folder Synchronization Logic](/syncthing/syncthing/how-does-syncthings-model-package-manage-core-folder-synchronization-logic)

Discover how Syncthing's model package orchestrates core folder synchronization logic with its hierarchical architecture, managing state machines and the pull-copy-push pipeline for efficient file syncing.

- Tags: internals
- Published: 2026-02-28

### [Syncthing Database Maintenance Tasks: Complete Guide to Scheduling and Manual Triggers](/syncthing/syncthing/what-database-maintenance-tasks-are-available-in-syncthing-and-when-should-they-be-performed)

Master Syncthing database maintenance. Learn default schedules, manual triggers via API, and essential tasks for optimal performance and reclaimed space. Keep your sync efficient.

- Tags: how-to-guide
- Published: 2026-02-28

### [How to Use the Syncthing CLI for Debugging Connection and Synchronization Issues](/syncthing/syncthing/how-can-i-use-the-syncthing-cli-for-debugging-connection-and-synchronization-issues)

Debug Syncthing connection and sync issues with the CLI. Inspect states, capture profiles, and generate support bundles directly from your terminal. Resolve problems efficiently.

- Tags: how-to-guide
- Published: 2026-02-28

### [Syncthing Authentication Methods: How the GUI and API Are Secured](/syncthing/syncthing/what-authentication-methods-does-syncthing-offer-to-secure-its-gui-and-api)

Explore Syncthing authentication methods securing its GUI and API. Learn about API keys, session logins with passwords or LDAP, and TLS encryption for robust protection.

- Tags: security
- Published: 2026-02-28

### [How Syncthing Implements NAT Traversal Using NAT-PMP and UPnP](/syncthing/syncthing/how-does-syncthing-implement-nat-traversal-using-protocols-like-pmp-and-upnp)

Discover how Syncthing implements NAT traversal using NAT-PMP and UPnP. Learn how it maps ports to expose internal services for seamless device connectivity.

- Tags: internals
- Published: 2026-02-28

### [How Index Exchange Between Syncthing Devices Works: Protocol and Consistency Mechanisms](/syncthing/syncthing/what-is-the-process-of-index-exchange-between-syncthing-devices-and-how-is-consistency-maintained)

Discover how Syncthing ensures index consistency across devices using monotonic sequence numbers, IndexID negotiation, and atomic database transactions for reliable file synchronization.

- Tags: internals
- Published: 2026-02-28

### [How Syncthing's Block Pull Reordering Algorithm Optimizes Transfer Performance](/syncthing/syncthing/how-does-syncthings-block-pull-reordering-algorithm-function-to-optimize-transfer-performance)

Discover how Syncthing's block pull reordering algorithm optimizes transfer performance. Learn about minimizing connection churn, prioritizing local chunks, and distributing peer load for faster syncs.

- Tags: performance
- Published: 2026-02-28

### [Syncthing Compression Algorithms: LZ4 Configuration and Setup Guide](/syncthing/syncthing/what-compression-algorithms-are-supported-by-syncthing-and-how-can-they-be-configured)

Learn how to configure Syncthing compression algorithms, focusing on LZ4 settings for the BEP protocol. Optimize your sync speeds with this setup guide.

- Tags: how-to-guide
- Published: 2026-02-28

### [Syncthing's File Versioning and Retention Policies: Complete Configuration Guide](/syncthing/syncthing/what-are-the-mechanisms-and-configuration-options-for-syncthings-file-versioning-and-retention-policies)

Master Syncthing file versioning and retention. Explore Simple, Staggered, Trash Can, and External strategies. Learn complete configuration options to protect your data effectively.

- Tags: how-to-guide
- Published: 2026-02-28

### [How Syncthing Relay Servers Facilitate Connectivity Through Firewalls and NAT](/syncthing/syncthing/how-do-syncthing-relay-servers-facilitate-connectivity-through-firewalls-and-nat)

Learn how Syncthing relay servers connect devices behind firewalls and NAT. Discover how relays forward encrypted traffic, bypassing inbound port restrictions for seamless peer-to-peer synchronization.

- Tags: internals
- Published: 2026-02-28

### [Performance and Reliability Differences Between TCP and QUIC Connections in Syncthing](/syncthing/syncthing/what-are-the-performance-and-reliability-differences-between-tcp-and-quic-connections-in-syncthing)

Explore TCP vs QUIC in Syncthing. Discover how QUIC delivers lower latency and better performance on challenging networks while TCP ensures compatibility and fallback reliability.

- Tags: performance
- Published: 2026-02-28

### [How Syncthing Device Discovery Works: Local Beacons and Global Servers](/syncthing/syncthing/how-does-syncthing-perform-device-discovery-using-local-network-beacons-and-discovery-servers)

Learn how Syncthing device discovery uses local UDP beacons and global HTTPS servers for seamless connectivity. Understand the Discovery Manager's role in finding devices on your LAN and the internet.

- Tags: internals
- Published: 2026-02-28

### [Syncthing Encrypted Receive (recvenc) Folders: Security Model and Implementation](/syncthing/syncthing/explain-the-security-model-and-implementation-of-syncthings-encrypted-receive-recvenc-folders)

Understand Syncthing's encrypted receive folders security: per-folder keys, deterministic AES-SIV filename encryption, and ChaCha20-Poly1305 block encryption protect your data.

- Tags: deep-dive
- Published: 2026-02-28

### [Syncthing Folder Types Explained: sendreceive, sendonly, receiveonly, and receiveencrypted](/syncthing/syncthing/how-do-syncthings-folder-types-sendrecv-sendonly-recvonly-recvenc-differ-in-behavior)

Understand Syncthing folder types sendrecv sendonly receiveonly and receiveencrypted to control data synchronization and encryption effectively.

- Tags: deep-dive
- Published: 2026-02-28

### [Syncthing SQLite Database Internal Structure: Complete Schema Guide](/syncthing/syncthing/what-is-the-internal-structure-of-syncthings-sqlite-database-and-its-key-tables)

Explore the Syncthing SQLite database internal structure and key tables. Learn how Syncthing manages folder state using a two-tier SQLite architecture with global and folder-specific databases.

- Tags: internals
- Published: 2026-02-28

### [What Is the Block Exchange Protocol (BEP) in Syncthing?](/syncthing/syncthing/what-is-the-bep-block-exchange-protocol-and-its-role-in-syncthings-synchronization)

Discover the Block Exchange Protocol BEP, Syncthings data transfer backbone. Learn how BEP manages secure, efficient file synchronization at the block level.

- Tags: internals
- Published: 2026-02-28

### [How Syncthing Handles Conflict Resolution for Concurrently Modified Files](/syncthing/syncthing/how-does-syncthing-handle-conflict-resolution-for-concurrently-modified-files)

Learn how Syncthing resolves conflicts for concurrently modified files. Discover its version vector comparison, content hashing, and winner selection methods to maintain data integrity.

- Tags: internals
- Published: 2026-02-28