Welcome to Syncthing’s documentation!

As a new user, the getting started guide is a good place to start, then perhaps moving on to the FAQ. If you run into trouble getting devices to connect to each other, the page about firewall setup explains the networking necessary to get it to work.

As a developer looking to get started with a contribution, see how to build, how to debug and the contribution guidelines. This documentation site can be edited on GitHub.

Contact

• If you’re looking for specific people to talk to, check out the Project Presentation.

• To report bugs or request features, please use the issue tracker. Before you do so, make sure you are running the latest version, and please do a quick search to see if the issue has already been reported.

  

• To report security issues, please follow the instructions on the Security page.

• To get help and support, discuss scenarios, or just connect with other users and developers you can head over to the friendly forum.

• For other concerns you may reach out to members of the maintainers, currently @calmh, @AudriusButkevicius and @imsodin.

• Introduction
  • Getting Started
  • An Intro to the GUI
  • Project Presentation
• Usage
  • Command Line Operation
  • FAQ
  • Versions & Releases
  • Configuration
  • Advanced Configuration
  • Folder Types
  • Introducer Configuration
  • The GUI Listen Address
  • LDAP Authentication
  • Configuration Tuning
  • Prometheus-Style Metrics
  • Understanding Synchronization
  • Untrusted (Encrypted) Devices
  • Firewall Setup
  • Relaying
  • Using Proxies
  • SSH Tunneling
  • Ignoring Files
  • File Versioning
  • Syncthing Discovery Server
  • Syncthing Relay Server
  • Custom Upgrade Server
  • Starting Syncthing Automatically
  • Community Contributions
  • Profiling
  • Reverse Proxy Setup
  • Security Principles
  • Automatic Crash Reporting
• Development
  • Introduction
  • Working on the Web GUI
  • Building Syncthing
  • Contribution Guidelines
  • Debugging Syncthing
  • Automatic Crash Reporting for Developers
  • Understanding Device IDs
  • Syncthing Infrastructure
  • Issue Management
  • Creating a Release
  • Release Signing
  • REST API
  • Event API
  • HTTP Utility Services API
• Specifications
  • Block Exchange Protocol v1
  • Global Discovery v3
  • Local Discovery Protocol v4
  • Relay Protocol v1
  • Untrusted Device Encryption

Thanks

We thank all the documentation contributors for their hard work:

Jakob Borg (calmh), Audrius Butkevicius, Simon Frei (imsodin), Tomasz Wilczyński, André Colomb (acolomb), Adam Piggott (ProactiveServices), Stefan Tatschner (rumpelsepp), Syncthing Release Automation, Nate Morrison (nrm21), Lode Hoste (Zillode), JohnVeness, Jerry Jacobs (xor-gate), Max, Lars K.W. Gohlke (lkwg82), Ross Smith II, Stefan Kuntz (Stefan-Code), Scott Klupfel (kluppy), bt90, Antony Male (canton7), Marc Laporte, Alexandre Viau (aviau), Cedric Staniewski (xduugu), Brian, Martchus, raferobinson, Peter Kaminski, Peter Gervai, Andrey D (scienmind), Austin S. Hemmelgarn, Peter Badida, Otto Jongerius, novoid, sa3dany, Frank Sachsenheim, Scott Hansen, bugith, C Bhushan, Stephen, Matt Sieren, camoz, Catfriend1, Tom Hale, Matt Burke (burkemw3), Matic Potočnik, Martin Lazarov, Pierre-Alain TORET, Unrud, Majed Abdulaziz (majedev), Louis Sautier, Valerii Hiora, Leo Arias (elopio), Daniel Clay Smith, Laurent Etiemble (letiemble), Wulf Weich (wweich), zertrin, DavidFair, Ken Marsh, alex2108, jodusnodus, Jesse Lucas, Alex Chan, 93-infinity, Iliyan, hlovdal, Gal Szkolnik, Emil Lundberg, Eric P, Evgeny Kuznetsov, krmathis, Mingwei Samuel, fferrann, Filip Harald, Francois-Xavier Gsell (zukoo), Frank Harper, fejese, Function-10, eddsalkield, Gavrilov Aleksej, Girish Ramakrishnan, graboluk, Göran Roseen, Heiko Zuerker (Smiley73), Edd Barrett, Ian Sullivan, Duncan Smart, iTob191, Ivan Vyshnevskyi, Dominik Schrempf, Jakob Egger, James Hartshorn, Jason, Jason Lingohr, jbratu, Jean-Denis Vauguet, Jeroen Evens, djtm, dinosore, Jimmy Jones, Jip-Hop, Jo Wouters, digital, John Buckley, Johnny Rock, dertalai, Jonathan Cross, Jonathan Vasquez, JsBergbau, jtagcat, ka7, Karol Pucyński, Kelong Cong (kc1212), Dennis Gaida, Kiryuu Sakuya, Kramoule, David Rimmer (dinosore), Kyle Manna, Dave Holland, Daniel O’Connor, dan2468, Leo Famulari, Linger206, Liu Siyuan (liusy182), Dakota, daftaupe, Luni, cron410, Cromefire_, Marcin Orlowski, marco-m, Mariano Rodríguez, Marius Volkhart, Cristian Mircea Messel, Martin Freund, Cory Salveson, Martin Michlmayr, Marwâne Chahed, cmillsa2, Christian Kellermann, Matt Kantor, Cameron Steffen, Matthew Davis, Matthew Harris, Matthias Braun, calvin ardi, Michael Vorburger ⛑️, Mike Nolta, MikeLund, Felix Ableitner (Nutomic), Morphy99, Moviuro, MrChenWithCapsule, mseravalli, Boris Rybalkin, NCDanielH, ngirard, NickPyz, Nico Stapelbroek, Nicolas Perraut, bigscoop, Oliver Freyermuth, Ooker, Oskar Okuno, bestlibre, Paweł Woźniak, Benjamin Masters, Peter Butkovic, Peter Dave Hello, Arthur Lutz, arneko, Phil Davis, Antoni Sawicki, Pitxyoki, Quentin Hibon, André-Patrick Bubel, Rahmi Pruitt, Rajshekhar K, Reto Kaiser, RichardUUU, rollbrettler, Romain Gay, Andrew Colin Kissa, rrosini, Andrej Shadura, Salim B, Samuel Li, Samuel Smoker, Sanjeev Gupta, sapient_cogbag, schnappijedi, Andreas Gohr, Anderson Mesquita (andersonvom), Sergio Livi, Anatoli Babenia, sliterok, Stefaan Ghysels, alexvoda, Alexandre Maurer, StefanKopieczek, Stefano Probst, Alexander Graf (alex2108), Alex Scammon, Sébastien Wains, Tamás Sallai, terrycloth, terzinnorbert, theincogtion, Thomas Dalichow, Thovthe, Tim Boudreau, Tobbe, Tobi, AJ ONeal, Adrian Rudnik, tuathail, twomice, Tyler Kropp, uglygus, abdeoliveira, Abdelrahman Abdelhafez, Vincent Ardern, Vincent Rischmann, Vium, Wieland Hoffmann, Willem Oosting, 4cdn, Yakov Litvin, 2nv2u, zocker-160