SYNCTHING-CONFIG(5)                Syncthing               SYNCTHING-CONFIG(5)



NNAAMMEE
       syncthing-config - Syncthing Configuration

SSYYNNOOPPSSIISS
          $HOME/.config/syncthing
          $HOME/Library/Application Support/Syncthing
          %LOCALAPPDATA%\Syncthing

DDEESSCCRRIIPPTTIIOONN
       New  in  version  1.5.0: Database and config can now be set separately.
       Previously the database was always located in the same directory as the
       config.


       Syncthing  uses  a  single  directory to store configuration and crypto
       keys.  Syncthing also has a database, which is  often  stored  in  this
       directory too.  The config location defaults to $$HHOOMMEE//..ccoonnffiigg//ssyynncctthhiinngg
       (Unix-like),  $$HHOOMMEE//LLiibbrraarryy//AApppplliiccaattiioonn  SSuuppppoorrtt//SSyynncctthhiinngg  (Mac),   or
       %%LLOOCCAALLAAPPPPDDAATTAA%%\\SSyynncctthhiinngg  (Windows). It can be changed at runtime using
       the ----ccoonnffiigg flag. In this directory the following files are located:

       ccoonnffiigg..xxmmll
              The configuration file, in XML format.

       cceerrtt..ppeemm,, kkeeyy..ppeemm
              The deviceâs ECDSA public and private key. These form the  basis
              for the device ID. The key must be kept private.

       hhttttppss--cceerrtt..ppeemm,, hhttttppss--kkeeyy..ppeemm
              The  certificate and key for HTTPS GUI connections. These may be
              replaced with a custom certificate for HTTPS as desired.

       ccssrrffttookkeennss..ttxxtt
              A list of recently issued CSRF tokens  (for  protection  against
              browser cross site request forgery).

       The database is stored either in the same directory as the config (usu‐
       ally the default), but may also be located  in  one  of  the  following
       directories (Unix-like platforms only):

       · If  a  database  exists in the old default location, that location is
         still used.

       · If $$XXDDGG__DDAATTAA__HHOOMMEE is set, use $$XXDDGG__DDAATTAA__HHOOMMEE//ssyynncctthhiinngg.

       · If ~~//..llooccaall//sshhaarree//ssyynncctthhiinngg exists, use that location.

       · Use the old default location (same as config).

       The location of the database can be changed using the ----ddaattaa flag.  The
       ----hhoommee  flag  sets both config and database locations at the same time.
       The database contains the following files:

       iinnddeexx--_*..ddbb
              A directory holding the database with metadata and hashes of the
              files currently on disk and available from peers.

CCOONNFFIIGG FFIILLEE FFOORRMMAATT
       The  following  shows  an  example of a default configuration file (IDs
       will differ):

       NNOOTTEE::
          The config examples are present for illustration. Do nnoott  copy  them
          entirely  to use as your config. They are likely out-of-date and the
          values may no longer correspond to the defaults.

          <configuration version="35">
              <folder id="default" label="Default Folder" path="/Users/jb/Sync/" type="sendreceive" rescanIntervalS="3600" fsWatcherEnabled="true" fsWatcherDelayS="10" ignorePerms="false" autoNormalize="true">
                  <filesystemType>basic</filesystemType>
                  <device id="S7UKX27-GI7ZTXS-GC6RKUA-7AJGZ44-C6NAYEB-HSKTJQK-KJHU2NO-CWV7EQW" introducedBy="">
                      <encryptionPassword></encryptionPassword>
                  </device>
                  <minDiskFree unit="%">1</minDiskFree>
                  <versioning>
                      <cleanupIntervalS>3600</cleanupIntervalS>
                      <fsPath></fsPath>
                      <fsType>basic</fsType>
                  </versioning>
                  <copiers>0</copiers>
                  <pullerMaxPendingKiB>0</pullerMaxPendingKiB>
                  <hashers>0</hashers>
                  <order>random</order>
                  <ignoreDelete>false</ignoreDelete>
                  <scanProgressIntervalS>0</scanProgressIntervalS>
                  <pullerPauseS>0</pullerPauseS>
                  <maxConflicts>-1</maxConflicts>
                  <disableSparseFiles>false</disableSparseFiles>
                  <disableTempIndexes>false</disableTempIndexes>
                  <paused>false</paused>
                  <weakHashThresholdPct>25</weakHashThresholdPct>
                  <markerName>.stfolder</markerName>
                  <copyOwnershipFromParent>false</copyOwnershipFromParent>
                  <modTimeWindowS>0</modTimeWindowS>
                  <maxConcurrentWrites>2</maxConcurrentWrites>
                  <disableFsync>false</disableFsync>
                  <blockPullOrder>standard</blockPullOrder>
                  <copyRangeMethod>standard</copyRangeMethod>
                  <caseSensitiveFS>false</caseSensitiveFS>
                  <junctionsAsDirs>false</junctionsAsDirs>
              </folder>
              <device id="S7UKX27-GI7ZTXS-GC6RKUA-7AJGZ44-C6NAYEB-HSKTJQK-KJHU2NO-CWV7EQW" name="syno" compression="metadata" introducer="false" skipIntroductionRemovals="false" introducedBy="">
                  <address>dynamic</address>
                  <paused>false</paused>
                  <autoAcceptFolders>false</autoAcceptFolders>
                  <maxSendKbps>0</maxSendKbps>
                  <maxRecvKbps>0</maxRecvKbps>
                  <ignoredFolder time="2022-01-09T19:09:52Z" id="br63e-wyhb7" label="Foo"></ignoredFolder>
                  <maxRequestKiB>0</maxRequestKiB>
                  <untrusted>false</untrusted>
                  <remoteGUIPort>0</remoteGUIPort>
              </device>
              <gui enabled="true" tls="false" debugging="false">
                  <address>127.0.0.1:8384</address>
                  <apikey>k1dnz1Dd0rzTBjjFFh7CXPnrF12C49B1</apikey>
                  <theme>default</theme>
              </gui>
              <ldap></ldap>
              <options>
                  <listenAddress>default</listenAddress>
                  <globalAnnounceServer>default</globalAnnounceServer>
                  <globalAnnounceEnabled>true</globalAnnounceEnabled>
                  <localAnnounceEnabled>true</localAnnounceEnabled>
                  <localAnnouncePort>21027</localAnnouncePort>
                  <localAnnounceMCAddr>[ff12::8384]:21027</localAnnounceMCAddr>
                  <maxSendKbps>0</maxSendKbps>
                  <maxRecvKbps>0</maxRecvKbps>
                  <reconnectionIntervalS>60</reconnectionIntervalS>
                  <relaysEnabled>true</relaysEnabled>
                  <relayReconnectIntervalM>10</relayReconnectIntervalM>
                  <startBrowser>true</startBrowser>
                  <natEnabled>true</natEnabled>
                  <natLeaseMinutes>60</natLeaseMinutes>
                  <natRenewalMinutes>30</natRenewalMinutes>
                  <natTimeoutSeconds>10</natTimeoutSeconds>
                  <urAccepted>0</urAccepted>
                  <urSeen>0</urSeen>
                  <urUniqueID></urUniqueID>
                  <urURL>https://data.syncthing.net/newdata</urURL>
                  <urPostInsecurely>false</urPostInsecurely>
                  <urInitialDelayS>1800</urInitialDelayS>
                  <restartOnWakeup>true</restartOnWakeup>
                  <autoUpgradeIntervalH>12</autoUpgradeIntervalH>
                  <upgradeToPreReleases>false</upgradeToPreReleases>
                  <keepTemporariesH>24</keepTemporariesH>
                  <cacheIgnoredFiles>false</cacheIgnoredFiles>
                  <progressUpdateIntervalS>5</progressUpdateIntervalS>
                  <limitBandwidthInLan>false</limitBandwidthInLan>
                  <minHomeDiskFree unit="%">1</minHomeDiskFree>
                  <releasesURL>https://upgrades.syncthing.net/meta.json</releasesURL>
                  <overwriteRemoteDeviceNamesOnConnect>false</overwriteRemoteDeviceNamesOnConnect>
                  <tempIndexMinBlocks>10</tempIndexMinBlocks>
                  <unackedNotificationID>authenticationUserAndPassword</unackedNotificationID>
                  <trafficClass>0</trafficClass>
                  <setLowPriority>true</setLowPriority>
                  <maxFolderConcurrency>0</maxFolderConcurrency>
                  <crashReportingURL>https://crash.syncthing.net/newcrash</crashReportingURL>
                  <crashReportingEnabled>true</crashReportingEnabled>
                  <stunKeepaliveStartS>180</stunKeepaliveStartS>
                  <stunKeepaliveMinS>20</stunKeepaliveMinS>
                  <stunServer>default</stunServer>
                  <databaseTuning>auto</databaseTuning>
                  <maxConcurrentIncomingRequestKiB>0</maxConcurrentIncomingRequestKiB>
                  <announceLANAddresses>true</announceLANAddresses>
                  <sendFullIndexOnUpgrade>false</sendFullIndexOnUpgrade>
                  <connectionLimitEnough>0</connectionLimitEnough>
                  <connectionLimitMax>0</connectionLimitMax>
                  <insecureAllowOldTLSVersions>false</insecureAllowOldTLSVersions>
              </options>
              <remoteIgnoredDevice time="2022-01-09T20:02:01Z" id="5SYI2FS-LW6YAXI-JJDYETS-NDBBPIO-256MWBO-XDPXWVG-24QPUM4-PDW4UQU" name="bugger" address="192.168.0.20:22000"></remoteIgnoredDevice>
              <defaults>
                  <folder id="" label="" path="~" type="sendreceive" rescanIntervalS="3600" fsWatcherEnabled="true" fsWatcherDelayS="10" ignorePerms="false" autoNormalize="true">
                      <filesystemType>basic</filesystemType>
                      <device id="S7UKX27-GI7ZTXS-GC6RKUA-7AJGZ44-C6NAYEB-HSKTJQK-KJHU2NO-CWV7EQW" introducedBy="">
                          <encryptionPassword></encryptionPassword>
                      </device>
                      <minDiskFree unit="%">1</minDiskFree>
                      <versioning>
                          <cleanupIntervalS>3600</cleanupIntervalS>
                          <fsPath></fsPath>
                          <fsType>basic</fsType>
                      </versioning>
                      <copiers>0</copiers>
                      <pullerMaxPendingKiB>0</pullerMaxPendingKiB>
                      <hashers>0</hashers>
                      <order>random</order>
                      <ignoreDelete>false</ignoreDelete>
                      <scanProgressIntervalS>0</scanProgressIntervalS>
                      <pullerPauseS>0</pullerPauseS>
                      <maxConflicts>10</maxConflicts>
                      <disableSparseFiles>false</disableSparseFiles>
                      <disableTempIndexes>false</disableTempIndexes>
                      <paused>false</paused>
                      <weakHashThresholdPct>25</weakHashThresholdPct>
                      <markerName>.stfolder</markerName>
                      <copyOwnershipFromParent>false</copyOwnershipFromParent>
                      <modTimeWindowS>0</modTimeWindowS>
                      <maxConcurrentWrites>2</maxConcurrentWrites>
                      <disableFsync>false</disableFsync>
                      <blockPullOrder>standard</blockPullOrder>
                      <copyRangeMethod>standard</copyRangeMethod>
                      <caseSensitiveFS>false</caseSensitiveFS>
                      <junctionsAsDirs>false</junctionsAsDirs>
                  </folder>
                  <device id="" compression="metadata" introducer="false" skipIntroductionRemovals="false" introducedBy="">
                      <address>dynamic</address>
                      <paused>false</paused>
                      <autoAcceptFolders>false</autoAcceptFolders>
                      <maxSendKbps>0</maxSendKbps>
                      <maxRecvKbps>0</maxRecvKbps>
                      <maxRequestKiB>0</maxRequestKiB>
                      <untrusted>false</untrusted>
                      <remoteGUIPort>0</remoteGUIPort>
                  </device>
              </defaults>
          </configuration>

CCOONNFFIIGGUURRAATTIIOONN EELLEEMMEENNTT
          <configuration version="35">
              <folder></folder>
              <device></device>
              <gui></gui>
              <ldap></ldap>
              <options></options>
              <remoteIgnoredDevice></remoteIgnoredDevice>
              <defaults></defaults>
          </configuration>

       This is the root element. It has one attribute:

       vveerrssiioonn
              The config version. Increments whenever a change  is  made  that
              requires migration from previous formats.

       It  contains  the  elements described in the following sections and any
       number of this additional child element:

       rreemmootteeIIggnnoorreeddDDeevviiccee
              Contains the ID of the device that should be ignored. Connection
              attempts  from  this  device are logged to the console but never
              displayed in the web GUI.

FFOOLLDDEERR EELLEEMMEENNTT
          <folder id="default" label="Default Folder" path="/Users/jb/Sync/" type="sendreceive" rescanIntervalS="3600" fsWatcherEnabled="true" fsWatcherDelayS="10" ignorePerms="false" autoNormalize="true">
              <filesystemType>basic</filesystemType>
              <device id="S7UKX27-GI7ZTXS-GC6RKUA-7AJGZ44-C6NAYEB-HSKTJQK-KJHU2NO-CWV7EQW" introducedBy="">
                  <encryptionPassword></encryptionPassword>
              </device>
              <minDiskFree unit="%">1</minDiskFree>
              <versioning>
                  <cleanupIntervalS>3600</cleanupIntervalS>
                  <fsPath></fsPath>
                  <fsType>basic</fsType>
              </versioning>
              <copiers>0</copiers>
              <pullerMaxPendingKiB>0</pullerMaxPendingKiB>
              <hashers>0</hashers>
              <order>random</order>
              <ignoreDelete>false</ignoreDelete>
              <scanProgressIntervalS>0</scanProgressIntervalS>
              <pullerPauseS>0</pullerPauseS>
              <maxConflicts>-1</maxConflicts>
              <disableSparseFiles>false</disableSparseFiles>
              <disableTempIndexes>false</disableTempIndexes>
              <paused>false</paused>
              <weakHashThresholdPct>25</weakHashThresholdPct>
              <markerName>.stfolder</markerName>
              <copyOwnershipFromParent>false</copyOwnershipFromParent>
              <modTimeWindowS>0</modTimeWindowS>
              <maxConcurrentWrites>2</maxConcurrentWrites>
              <disableFsync>false</disableFsync>
              <blockPullOrder>standard</blockPullOrder>
              <copyRangeMethod>standard</copyRangeMethod>
              <caseSensitiveFS>false</caseSensitiveFS>
              <junctionsAsDirs>false</junctionsAsDirs>
          </folder>

       One or more ffoollddeerr elements must be present in the file.  Each  element
       describes one folder. The following attributes may be set on the ffoollddeerr
       element:

       iidd ((mmaannddaattoorryy))
              The folder ID, which must be unique.

       llaabbeell  The label of a folder is a human readable and descriptive  local
              name.  May  be different on each device, empty, and/or identical
              to other folder labels. (optional)

       ffiilleessyysstteemmTTyyppee
              The internal file system  implementation  used  to  access  this
              folder, detailed in a separate chapter.

       ppaatthh ((mmaannddaattoorryy))
              The  path  to  the  directory where the folder is stored on this
              device; not sent to other devices.

       ttyyppee   Controls how the folder is handled by Syncthing. Possible values
              are:

              sseennddrreecceeiivvee
                     The  folder is in default mode. Sending local and accept‐
                     ing remote changes.  Note that this type  was  previously
                     called âreadwriteâ which is deprecated but still accepted
                     in incoming configs.

              sseennddoonnllyy
                     The folder is in âsend onlyâ mode â it will not be  modi‐
                     fied  by  Syncthing  on this device.  Note that this type
                     was previously called âreadonlyâ which is deprecated  but
                     still accepted in incoming configs.

              rreecceeiivveeoonnllyy
                     The folder is in âreceive onlyâ mode â it will not propa‐
                     gate changes to other devices.

              rreecceeiivveeeennccrryypptteedd
                     Must be used on untrusted devices, where the data  cannot
                     be decrypted because no folder password was entered.  See
                     untrusted.

       rreessccaannIInntteerrvvaallSS
              The rescan interval, in seconds. Can be set to 00 to disable when
              external plugins are used to trigger rescans.

       ffssWWaattcchheerrEEnnaabblleedd
              If  set to ttrruuee, this detects changes to files in the folder and
              scans them.

       ffssWWaattcchheerrDDeellaayySS
              The duration during  which  changes  detected  are  accumulated,
              before   a   scan   is   scheduled   (only   takes   effect   if
              _f_s_W_a_t_c_h_e_r_E_n_a_b_l_e_d is set to ttrruuee).

       iiggnnoorreePPeerrmmss
              If ttrruuee, files originating from this folder will be announced to
              remote  devices  with the âno permission bitsâ flag.  The remote
              devices will use whatever their default  permission  setting  is
              when  creating the files.  The primary use case is for file sys‐
              tems that do not support permissions, such as FAT,  or  environ‐
              ments where changing permissions is impossible.

       aauuttooNNoorrmmaalliizzee
              Automatically  correct  UTF-8 normalization errors found in file
              names.  The mechanism and how to set it up  is  described  in  a
              separate chapter.

       The following child elements may exist:

       ddeevviiccee These  must  have  the iidd attribute and can have an iinnttrroodduucceeddBByy
              attribute, identifying the device that introduced  us  to  share
              this  folder  with the given device.  If the original introducer
              unshares this folder with this device, our  device  will  follow
              and  unshare  the  folder  (subject  to _s_k_i_p_I_n_t_r_o_d_u_c_t_i_o_n_R_e_m_o_v_a_l_s
              being ffaallssee on the introducer device).

              All mentioned devices are those that will be sharing the  folder
              in  question.  Each mentioned device must have a separate ddeevviiccee
              element later in the file.   It  is  customary  that  the  local
              device  ID is included in all folders.  Syncthing will currently
              add this automatically if it is not present in the configuration
              file.

              The eennccrryyppttiioonnPPaasssswwoorrdd sub-element contains the secret needed to
              decrypt this folderâs data on the remote device.  If left empty,
              the  data  is  plainly  accessible  (but  still protected by the
              transport encryption).  The mechanism and how to set  it  up  is
              described in a separate chapter.

       mmiinnDDiisskkFFrreeee
              The  minimum required free space that should be available on the
              disk this folder resides.  The folder will be stopped  when  the
              value  drops below the threshold.  The element content is inter‐
              preted according to the given  uunniitt  attribute.   Accepted  uunniitt
              values are %% (percent of the disk / volume size), kkBB, MMBB, GGBB and
              TTBB.  Set to zero to disable.

       vveerrssiioonniinngg
              Specifies a versioning configuration.

              SSEEEE AALLSSOO::
                 versioning

       ccooppiieerrss

       hhaasshheerrss
              The number of copier and hasher routines to use, or  00  for  the
              system  determined  optimums.  These  are  low-level performance
              options for advanced users only; do not change unless  requested
              to or youâve actually read and understood the code yourself. :)

       ppuulllleerrMMaaxxPPeennddiinnggKKiiBB
              Controls  when  we  stop  sending requests to other devices once
              weâve got this much unserved requests.  The number of pullers is
              automatically adjusted based on this desired amount of outstand‐
              ing request data.

       oorrddeerr  The order in which needed files should be pulled from the  clus‐
              ter.  It has no effect when the folder type is âsend onlyâ.  The
              possibles values are:

              rraannddoomm ((ddeeffaauulltt))
                     Pull files in random order. This optimizes for  balancing
                     resources among the devices in a cluster.

              aallpphhaabbeettiicc
                     Pull files ordered by file name alphabetically.

              ssmmaalllleessttFFiirrsstt,, llaarrggeessttFFiirrsstt
                     Pull  files  ordered  by  file size; smallest and largest
                     first respectively.

              oollddeessttFFiirrsstt,, nneewweessttFFiirrsstt
                     Pull files ordered by modification time; oldest and  new‐
                     est first respectively.

              Note  that the scanned files are sent in batches and the sorting
              is applied only to the already discovered files. This means  the
              sync  might  start  with  a 1 GB file even if there is 1 KB file
              available on the source device until the 1 KB becomes  known  to
              the pulling device.

       iiggnnoorreeDDeelleettee
              WWAARRNNIINNGG::
                 Enabling  this  is highly discouraged - use at your own risk.
                 You have been warned.

              When set to ttrruuee, this device will pretend not to  see  instruc‐
              tions  to  delete  files  from  other devices.  The mechanism is
              described in a separate chapter.

       ssccaannPPrrooggrreessssIInntteerrvvaallSS
              The interval in seconds with which scan progress information  is
              sent  to  the  GUI. Setting to 00 will cause Syncthing to use the
              default value of two.

       ppuulllleerrPPaauusseeSS
              Tweak for rate limiting  the  puller  when  it  retries  pulling
              files. Donât change this unless you know what youâre doing.

       mmaaxxCCoonnfflliiccttss
              The  maximum  number  of  conflict copies to keep around for any
              given file.  The default, --11, means an unlimited number. Setting
              this to 00 disables conflict copies altogether.

       ddiissaabblleeSSppaarrsseeFFiilleess
              By default, blocks containing all zeros are not written, causing
              files to be sparse on filesystems  that  support  this  feature.
              When set to ttrruuee, sparse files will not be created.

       ddiissaabblleeTTeemmppIInnddeexxeess
              By  default, devices exchange information about blocks available
              in transfers that are still  in  progress,  which  allows  other
              devices  to download parts of files that are not yet fully down‐
              loaded on your own device,  essentially  making  transfers  more
              torrent  like.  When  set  to  ttrruuee,  such  information  is  not
              exchanged for this folder.

       ppaauusseedd True if this folder is (temporarily) suspended.

       wweeaakkHHaasshhTThhrreesshhoollddPPcctt
              Use weak hash if more than the given percentage of the file  has
              changed. Set to --11 to always use weak hash. Default is 2255.

       mmaarrkkeerrNNaammee
              Name  of  a  directory  or file in the folder root to be used as
              marker-faq. Default is ..ssttffoollddeerr.

       ccooppyyOOwwnneerrsshhiippFFrroommPPaarreenntt
              On Unix systems, tries to copy file/folder  ownership  from  the
              parent directory (the directory itâs located in).  Requires run‐
              ning Syncthing as a privileged user, or granting  it  additional
              capabilities (e.g. CAP_CHOWN on Linux).

       mmooddTTiimmeeWWiinnddoowwSS
              Allowed  modification  timestamp difference when comparing files
              for equivalence. To be used on file systems which have  unstable
              modification  timestamps  that might change after being recorded
              during the last write operation. Default is 22  on  Android  when
              the folder is located on a FAT partition, and 00 otherwise.

       mmaaxxCCoonnccuurrrreennttWWrriitteess
              Maximum  number  of  concurrent  write operations while syncing.
              Increasing this might increase  or  decrease  disk  performance,
              depending on the underlying storage. Default is 22.

       ddiissaabblleeFFssyynncc
              WWAARRNNIINNGG::
                 This is a known insecure option - use at your own risk.

              Disables  committing  file  operations  to disk before recording
              them in the database.  Disabling fsync can lead to data  corrup‐
              tion.  The mechanism is described in a separate chapter.

       bblloocckkPPuullllOOrrddeerr
              Order  in which the blocks of a file are downloaded. This option
              controls how quickly different parts of the file spread  between
              the  connected  devices,  at  the  cost of causing strain on the
              storage.

              Available options:

              ssttaannddaarrdd ((ddeeffaauulltt))
                     The blocks of a file are split into  N  equal  continuous
                     sequences,  where  N  is the number of connected devices.
                     Each device starts downloading its  own  sequence,  after
                     which  it  picks  other devices sequences at random. Pro‐
                     vides acceptable data distribution and  minimal  spinning
                     disk strain.

              rraannddoomm The  blocks  of  a file are downloaded in a random order.
                     Provides great data  distribution,  but  very  taxing  on
                     spinning disk drives.

              iinnOOrrddeerr
                     The  blocks  of  a file are downloaded sequentially, from
                     start to finish. Spinning disk drive friendly,  but  pro‐
                     vides no improvements to data distribution.

       ccooppyyRRaannggeeMMeetthhoodd
              Provides  a  choice  of  method  for copying data between files.
              This can be used to  optimise  copies  on  network  filesystems,
              improve   speed   of  large  copies  or  clone  the  data  using
              copy-on-write functionality if the  underlying  filesystem  sup‐
              ports it.  The mechanism is described in a separate chapter.

       ccaasseeSSeennssiittiivveeFFSS
              Affects  performance  by  disabling  the extra safety checks for
              case insensitive filesystems.  The mechanism and how to  set  it
              up is described in a separate chapter.

       jjuunnccttiioonnssAAssDDiirrss
              NTFS directory junctions are treated as ordinary directories, if
              this is set to ttrruuee.

DDEEVVIICCEE EELLEEMMEENNTT
          <device id="S7UKX27-GI7ZTXS-GC6RKUA-7AJGZ44-C6NAYEB-HSKTJQK-KJHU2NO-CWV7EQW" name="syno" compression="metadata" introducer="false" skipIntroductionRemovals="false" introducedBy="2CYF2WQ-AKZO2QZ-JAKWLYD-AGHMQUM-BGXUOIS-GYILW34-HJG3DUK-LRRYQAR">
              <address>dynamic</address>
              <paused>false</paused>
              <autoAcceptFolders>false</autoAcceptFolders>
              <maxSendKbps>0</maxSendKbps>
              <maxRecvKbps>0</maxRecvKbps>
              <ignoredFolder time="2022-01-09T19:09:52Z" id="br63e-wyhb7" label="Foo"></ignoredFolder>
              <maxRequestKiB>0</maxRequestKiB>
              <untrusted>false</untrusted>
              <remoteGUIPort>0</remoteGUIPort>
          </device>
          <device id="2CYF2WQ-AKZO2QZ-JAKWLYD-AGHMQUM-BGXUOIS-GYILW34-HJG3DUK-LRRYQAR" name="syno local" compression="metadata" introducer="true" skipIntroductionRemovals="false" introducedBy="">
              <address>tcp://192.0.2.1:22001</address>
              <paused>true</paused>
              <allowedNetwork>192.168.0.0/16</allowedNetwork>
              <autoAcceptFolders>false</autoAcceptFolders>
              <maxSendKbps>100</maxSendKbps>
              <maxRecvKbps>100</maxRecvKbps>
              <maxRequestKiB>65536</maxRequestKiB>
              <untrusted>false</untrusted>
              <remoteGUIPort>8384</remoteGUIPort>
          </device>

       One or more ddeevviiccee elements must be present in the file.  Each  element
       describes  a  device  participating  in the cluster. It is customary to
       include a ddeevviiccee element for the local device; Syncthing will currently
       add  one  if  it is not present. The following attributes may be set on
       the ddeevviiccee element:

       iidd ((mmaannddaattoorryy))
              The device ID.

       nnaammee   A friendly name for the device. (optional)

       ccoommpprreessssiioonn
              Whether to use protocol compression  when  sending  messages  to
              this device.  The possible values are:

              mmeettaaddaattaa
                     Compress  metadata  packets,  such  as index information.
                     Metadata is usually very compression friendly so this  is
                     a good default.

              aallwwaayyss Compress all packets, including file data. This is recom‐
                     mended if the folders contents  are  mainly  compressible
                     data such as documents or text files.

              nneevveerr  Disable all compression.

       iinnttrroodduucceerr
              Set  to  true if this device should be trusted as an introducer,
              i.e. we should copy their list of devices per folder  when  con‐
              necting.

              SSEEEE AALLSSOO::
                 introducer

       sskkiippIInnttrroodduuccttiioonnRReemmoovvaallss
              Set  to  true  if  you wish to follow only introductions and not
              de-introductions.  For example, if this is  set,  we  would  not
              remove  a device that we were introduced to even if the original
              introducer is no longer listing the remote device as known.

       iinnttrroodduucceeddBByy
              Defines which device has introduced us to this device. Used only
              for following de-introductions.

       cceerrttNNaammee
              The  device  certificateâs common name, if it is not the default
              âsyncthingâ.

       From the following child elements  at  least  one  aaddddrreessss  child  must
       exist.

       aaddddrreessss ((mmaannddaattoorryy:: AAtt lleeaasstt oonnee mmuusstt bbee pprreesseenntt..))
              Contains  an address or host name to use when attempting to con‐
              nect to this device.  Entries other than ddyynnaammiicc need a protocol
              specific  prefix.  For  the  TCP  protocol  the  prefixes ttccpp::////
              (dual-stack), ttccpp44:://// (IPv4 only) or ttccpp66:://// (IPv6 only) can  be
              used.   The  prefixes  for  the  QUIC  protocol  are  analogous:
              qquuiicc::////, qquuiicc44:://// and qquuiicc66:://// Note that IP addresses  need  not
              use  IPv4 or IPv6 prefixes; these are optional. Accepted formats
              are:

              IIPPvv44 aaddddrreessss ((ttccpp::////119922..00..22..4422))
                     The default port (22000) is used.

              IIPPvv44 aaddddrreessss aanndd ppoorrtt ((ttccpp::////119922..00..22..4422::1122334455))
                     The address and port is used as given.

              IIPPvv66 aaddddrreessss ((ttccpp::////[[22000011::ddbb88::::2233::4422]]))
                     The default port (22000) is used.  The  address  must  be
                     enclosed in square brackets.

              IIPPvv66 aaddddrreessss aanndd ppoorrtt ((ttccpp::////[[22000011::ddbb88::::2233::4422]]::1122334455))
                     The  address  and port is used as given. The address must
                     be enclosed in square brackets.

              HHoosstt nnaammee ((ttccpp66::////ffiilleesseerrvveerr))
                     The host name will be used on the  default  port  (22000)
                     and connections will be attempted only via IPv6.

              HHoosstt nnaammee aanndd ppoorrtt ((ttccpp::////ffiilleesseerrvveerr::1122334455))
                     The  host name will be used on the given port and connec‐
                     tions will be attempted via both IPv4 and IPv6, depending
                     on name resolution.

              ddyynnaammiicc
                     The  word ddyynnaammiicc (without any prefix) means to use local
                     and global discovery to find the device.

              You can set multiple addresses _a_n_d combine it with  the  ddyynnaammiicc
              keyword for example:

                 <device id="...">
                     <address>tcp://192.0.2.1:22001</address>
                     <address>quic://192.0.1.254:22000</address>
                     <address>dynamic</address>
                 </device>

       ppaauusseedd True  if synchronization with this devices is (temporarily) sus‐
              pended.

       aalllloowweeddNNeettwwoorrkk
              If given, this restricts connections to this device to only this
              network.   The  mechanism  is  described in detail in a separate
              chapter).

       aauuttooAAcccceeppttFFoollddeerrss
              If ttrruuee, folders shared from this remote  device  are  automati‐
              cally  added and synced locally under the _d_e_f_a_u_l_t _p_a_t_h.  For the
              folder name, Syncthing tries to use the label  from  the  remote
              device,  and  if the same label already exists, it then tries to
              use the folderâs ID.  If that exists as well, the folder is just
              offered  to  accept manually.  A local folder already added with
              the same ID will just be shared rather than created separately.

       mmaaxxSSeennddKKbbppss
              Maximum send rate to use for this device. Unit is kibibytes/sec‐
              ond, despite the config name looking like kilobits/second.

       mmaaxxRReeccvvKKbbppss
              Maximum   receive   rate   to  use  for  this  device.  Unit  is
              kibibytes/second, despite the config  name  looking  like  kilo‐
              bits/second.

       iiggnnoorreeddFFoollddeerr
              Contains  the  ID  of  the  folder  that should be ignored. This
              folder will always be skipped when advertised from the  contain‐
              ing  remote  device, i.e. this will be logged, but there will be
              no dialog shown in the web GUI.

       mmaaxxRReeqquueessttKKiiBB
              Maximum amount of data to have outstanding in  requests  towards
              this device.  Unit is kibibytes.

       rreemmootteeGGUUIIPPoorrtt
              If  set to a positive integer, the GUI will display an HTTP link
              to the IP address which is currently used  for  synchronization.
              Only  the  TCP  port  is exchanged for the value specified here.
              Note that any port forwarding or firewall settings  need  to  be
              done manually and the link will probably not work for link-local
              IPv6 addresses because of modern browser limitations.

       uunnttrruusstteedd
              This boolean value marks a particular device as untrusted, which
              disallows  ever  sharing  any  unencrypted  data with it.  Every
              folder shared with that device then needs an encryption password
              set, or must already be of the âreceive encryptedâ type locally.
              Refer to the detailed explanation under untrusted.

GGUUII EELLEEMMEENNTT
          <gui enabled="true" tls="false" debugging="false">
              <address>127.0.0.1:8384</address>
              <apikey>k1dnz1Dd0rzTBjjFFh7CXPnrF12C49B1</apikey>
              <theme>default</theme>
          </gui>

       There must be exactly one gguuii element. The GUI  configuration  is  also
       used by the /dev/rest and the /dev/events. The following attributes may
       be set on the gguuii element:

       eennaabblleedd
              If not ttrruuee, the GUI and API will not be started.

       ttllss    If set to ttrruuee, TLS (HTTPS) will be enforced. Non-HTTPS requests
              will  be redirected to HTTPS. When set to ffaallssee, TLS connections
              are still possible but not required.

       ddeebbuuggggiinngg
              This enables /users/profiling and additional  endpoints  in  the
              REST API, see /rest/debug.

       The following child elements may be present:

       aaddddrreessss ((mmaannddaattoorryy:: EExxaaccttllyy oonnee eelleemmeenntt mmuusstt bbee pprreesseenntt..))
              Set the listen address.  Allowed address formats are:

              IIPPvv44 aaddddrreessss aanndd ppoorrtt ((112277..00..00..11::88338844))
                     The address and port are used as given.

              IIPPvv66 aaddddrreessss aanndd ppoorrtt (([[::::11]]::88338844))
                     The  address and port are used as given. The address must
                     be enclosed in square brackets.

              WWiillddccaarrdd aanndd ppoorrtt ((00..00..00..00::1122334455,, [[::::]]::1122334455,, ::1122334455))
                     These are equivalent and will result in Syncthing listen‐
                     ing on all interfaces via both IPv4 and IPv6.

              UUNNIIXX ssoocckkeett llooccaattiioonn ((//vvaarr//rruunn//sstt..ssoocckk))
                     If  the  address is an absolute path it is interpreted as
                     the path to a UNIX socket.

       uunniixxSSoocckkeettPPeerrmmiissssiioonnss
              When aaddddrreessss is set to a UNIX socket location, set  this  to  an
              octal value to override the default permissions of the socket.

       uusseerr   Set to require authentication.

       ppaasssswwoorrdd
              Contains the bcrypt hash of the real password.

       aappiikkeeyy If  set,  this  is  the  API  key that enables usage of the REST
              interface.

       iinnsseeccuurreeAAddmmiinnAAcccceessss
              If true, this allows access to the web GUI  from  outside  (i.e.
              not  localhost)  without authorization. A warning will displayed
              about this setting on startup.

       iinnsseeccuurreeSSkkiippHHoossttcchheecckk
              When the GUI / API is bound to localhost, we  enforce  that  the
              HHoosstt  header  looks  like  localhost.  This option bypasses that
              check.

       iinnsseeccuurreeAAlllloowwFFrraammeeLLooaaddiinngg
              Allow rendering the GUI within an <<iiffrraammee>>, <<ffrraammee>> or  <<oobbjjeecctt>>
              by  not  setting  the  XX--FFrraammee--OOppttiioonnss::  SSAAMMEEOORRIIGGIINN HTTP header.
              This may be needed for serving the Syncthing GUI as  part  of  a
              website through a proxy.

       tthheemmee  The name of the theme to use.

       aauutthhMMooddee
              Authentication  mode  to use. If not present, the authentication
              mode (static) is controlled by  the  presence  of  user/password
              fields for backward compatibility.

              ssttaattiicc Authentication using user and password.

              llddaapp   LDAP  authentication. Requires ldap top level config sec‐
                     tion to be present.

LLDDAAPP EELLEEMMEENNTT
          <ldap>
              <address>localhost:389</address>
              <bindDN>cn=%s,ou=users,dc=syncthing,dc=net</bindDN>
              <transport>nontls</transport>
              <insecureSkipVerify>false</insecureSkipVerify>
          </ldap>

       The llddaapp element contains LDAP configuration options.  The mechanism is
       described in detail under ldap.

       aaddddrreessss ((mmaannddaattoorryy))
                 LDAP server address (server:port).

       bbiinnddDDNN ((mmaannddaattoorryy))
                 BindDN  for  user authentication.  Special %%ss variable should
                 be used to pass username to LDAP.

       ttrraannssppoorrtt

              nnoonnttllss Non secure connection.

              ttllss    TLS secured connection.

              ssttaarrttttllss
                     StartTLS connection mode.

       iinnsseeccuurreeSSkkiippVVeerriiffyy
              Skip verification (ttrruuee or ffaallssee).

       sseeaarrcchhBBaasseeDDNN
              Base DN for user searches.

       sseeaarrcchhFFiilltteerr
              Search filter for user searches.

OOPPTTIIOONNSS EELLEEMMEENNTT
          <options>
              <listenAddress>default</listenAddress>
              <globalAnnounceServer>default</globalAnnounceServer>
              <globalAnnounceEnabled>true</globalAnnounceEnabled>
              <localAnnounceEnabled>true</localAnnounceEnabled>
              <localAnnouncePort>21027</localAnnouncePort>
              <localAnnounceMCAddr>[ff12::8384]:21027</localAnnounceMCAddr>
              <maxSendKbps>0</maxSendKbps>
              <maxRecvKbps>0</maxRecvKbps>
              <reconnectionIntervalS>60</reconnectionIntervalS>
              <relaysEnabled>true</relaysEnabled>
              <relayReconnectIntervalM>10</relayReconnectIntervalM>
              <startBrowser>true</startBrowser>
              <natEnabled>true</natEnabled>
              <natLeaseMinutes>60</natLeaseMinutes>
              <natRenewalMinutes>30</natRenewalMinutes>
              <natTimeoutSeconds>10</natTimeoutSeconds>
              <urAccepted>0</urAccepted>
              <urSeen>0</urSeen>
              <urUniqueID></urUniqueID>
              <urURL>https://data.syncthing.net/newdata</urURL>
              <urPostInsecurely>false</urPostInsecurely>
              <urInitialDelayS>1800</urInitialDelayS>
              <restartOnWakeup>true</restartOnWakeup>
              <autoUpgradeIntervalH>12</autoUpgradeIntervalH>
              <upgradeToPreReleases>false</upgradeToPreReleases>
              <keepTemporariesH>24</keepTemporariesH>
              <cacheIgnoredFiles>false</cacheIgnoredFiles>
              <progressUpdateIntervalS>5</progressUpdateIntervalS>
              <limitBandwidthInLan>false</limitBandwidthInLan>
              <minHomeDiskFree unit="%">1</minHomeDiskFree>
              <releasesURL>https://upgrades.syncthing.net/meta.json</releasesURL>
              <overwriteRemoteDeviceNamesOnConnect>false</overwriteRemoteDeviceNamesOnConnect>
              <tempIndexMinBlocks>10</tempIndexMinBlocks>
              <unackedNotificationID>authenticationUserAndPassword</unackedNotificationID>
              <trafficClass>0</trafficClass>
              <setLowPriority>true</setLowPriority>
              <maxFolderConcurrency>0</maxFolderConcurrency>
              <crashReportingURL>https://crash.syncthing.net/newcrash</crashReportingURL>
              <crashReportingEnabled>true</crashReportingEnabled>
              <stunKeepaliveStartS>180</stunKeepaliveStartS>
              <stunKeepaliveMinS>20</stunKeepaliveMinS>
              <stunServer>default</stunServer>
              <databaseTuning>auto</databaseTuning>
              <maxConcurrentIncomingRequestKiB>0</maxConcurrentIncomingRequestKiB>
              <announceLANAddresses>true</announceLANAddresses>
              <sendFullIndexOnUpgrade>false</sendFullIndexOnUpgrade>
              <connectionLimitEnough>0</connectionLimitEnough>
              <connectionLimitMax>0</connectionLimitMax>
              <insecureAllowOldTLSVersions>false</insecureAllowOldTLSVersions>
          </options>

       The ooppttiioonnss element contains all other global configuration options.

       lliisstteennAAddddrreessss
              The listen address for incoming  sync  connections.  See  _L_i_s_t_e_n
              _A_d_d_r_e_s_s_e_s for the allowed syntax.

       gglloobbaallAAnnnnoouunncceeSSeerrvveerr
              A  URI  to  a  global  announce  (discovery) server, or the word
              ddeeffaauulltt to include the default servers. Any number of  globalAn‐
              nounceServer elements may be present. The syntax for non-default
              entries is that of an HTTP or HTTPS URL. A number of options may
              be  added  as query options to the URL: iinnsseeccuurree to prevent cer‐
              tificate validation (required for HTTP URLs) and iidd==<<ddeevviiccee  IIDD>>
              to  perform certificate pinning. The device ID to use is printed
              by the discovery server on startup.

       gglloobbaallAAnnnnoouunncceeEEnnaabblleedd
              Whether to announce this device to the global announce  (discov‐
              ery) server, and also use it to look up other devices.

       llooccaallAAnnnnoouunncceeEEnnaabblleedd
              Whether  to  send  announcements to the local LAN, also use such
              announcements to find other devices.

       llooccaallAAnnnnoouunncceePPoorrtt
              The port on which to listen and send  IPv4  broadcast  announce‐
              ments to.

       llooccaallAAnnnnoouunncceeMMCCAAddddrr
              The  group  address  and  port  to  join and send IPv6 multicast
              announcements on.

       mmaaxxSSeennddKKbbppss
              Outgoing data rate limit, in kibibytes per second.

       mmaaxxRReeccvvKKbbppss
              Incoming data rate limits, in kibibytes per second.

       rreeccoonnnneeccttiioonnIInntteerrvvaallSS
              The number of seconds to wait between each attempt to connect to
              currently unconnected devices.

       rreellaayyssEEnnaabblleedd
              When  ttrruuee, relays will be connected to and potentially used for
              device to device connections.

       rreellaayyRReeccoonnnneeccttIInntteerrvvaallMM
              Sets the interval, in minutes, between relay reconnect attempts.

       ssttaarrttBBrroowwsseerr
              Whether to attempt to start a browser to show the GUI when Sync‐
              thing starts.

       nnaattEEnnaabblleedd
              Whether  to  attempt  to perform a UPnP and NAT-PMP port mapping
              for incoming sync connections.

       nnaattLLeeaasseeMMiinnuutteess
              Request a lease for this many minutes; zero to request a  perma‐
              nent lease.

       nnaattRReenneewwaallMMiinnuutteess
              Attempt to renew the lease after this many minutes.

       nnaattTTiimmeeoouuttSSeeccoonnddss
              When scanning for UPnP devices, wait this long for responses.

       uurrAAcccceepptteedd
              Whether  the  user  has accepted to submit anonymous usage data.
              The default, 00, mean the user has not made a choice,  and  Sync‐
              thing  will ask at some point in the future. --11 means no, a num‐
              ber above zero means that that version of  usage  reporting  has
              been accepted.

       uurrSSeeeenn The  highest usage reporting version that has already been shown
              in the web GUI.

       uurrUUnniiqquueeIIDD
              The unique ID sent together with  the  usage  report.  Generated
              when usage reporting is enabled.

       uurrUURRLL  The URL to post usage report data to, when enabled.

       uurrPPoossttIInnsseeccuurreellyy
              When  true,  the  UR URL can be http instead of https, or have a
              self-signed certificate. The default is ffaallssee.

       uurrIInniittiiaallDDeellaayySS
              The time to wait from startup for the first usage report  to  be
              sent.  Allows  the  system to stabilize before reporting statis‐
              tics.

       rreessttaarrttOOnnWWaakkeeuupp
              Whether to perform a restart of Syncthing when  it  is  detected
              that we are waking from sleep mode (i.e. an unfolding laptop).

       aauuttooUUppggrraaddeeIInntteerrvvaallHH
              Check  for  a  newer  version after this many hours. Set to 00 to
              disable automatic upgrades.

       uuppggrraaddeeTTooPPrreeRReelleeaasseess
              If ttrruuee, automatic  upgrades  include  release  candidates  (see
              releases).

       kkeeeeppTTeemmppoorraarriieessHH
              Keep  temporary  failed transfers for this many hours. While the
              temporaries are kept, the data they contain need not  be  trans‐
              ferred again.

       ccaacchheeIIggnnoorreeddFFiilleess
              Whether  to cache the results of ignore pattern evaluation. Per‐
              formance at the price of memory. Defaults to ffaallssee as  the  cost
              for evaluating ignores is usually not significant.

       pprrooggrreessssUUppddaatteeIInntteerrvvaallSS
              How  often  in seconds the progress of ongoing downloads is made
              available to the GUI.

       lliimmiittBBaannddwwiiddtthhIInnLLaann
              Whether to apply bandwidth limits to devices in the same  broad‐
              cast domain as the local device.

       mmiinnHHoommeeDDiisskkFFrreeee
              The  minimum required free space that should be available on the
              partition holding the configuration and index.  The element con‐
              tent  is  interpreted  according  to  the  given uunniitt attribute.
              Accepted uunniitt values are %% (percent of the disk / volume  size),
              kkBB, MMBB, GGBB and TTBB.  Set to zero to disable.

       rreelleeaasseessUURRLL
              The  URL from which release information is loaded, for automatic
              upgrades.

       aallwwaayyssLLooccaallNNeett
              Network that should be considered as local given in  CIDR  nota‐
              tion.

       oovveerrwwrriitteeRReemmootteeDDeevviicceeNNaammeessOOnnCCoonnnneecctt
              If  set,  device  names will always be overwritten with the name
              given by remote on each connection. By default,  the  name  that
              the remote device announces will only be adopted when a name has
              not already been set.

       tteemmppIInnddeexxMMiinnBBlloocckkss
              When exchanging index information for incomplete transfers, only
              take into account files that have at least this many blocks.

       uunnaacckkeeddNNoottiiffiiccaattiioonnIIDD
              ID  of  a  notification  to be displayed in the web GUI. Will be
              removed once the user acknowledged it (e.g. an transition notice
              on an upgrade).

       ttrraaffffiiccCCllaassss
              Specify  a type of service (TOS)/traffic class of outgoing pack‐
              ets.

       ssttuunnSSeerrvveerr
              Server to be used  for  STUN,  given  as  ip:port.  The  keyword
              ddeeffaauulltt gets expanded to ssttuunn..ccaallllwwiitthhuuss..ccoomm::33447788, ssttuunn..ccoouunntteerr‐‐
              ppaatthh..ccoomm::33447788,  ssttuunn..ccoouunntteerrppaatthh..nneett::33447788,  ssttuunn..eekkiiggaa..nneett::33447788,
              ssttuunn..iiddeeaassiipp..ccoomm::33447788,              ssttuunn..iinntteerrnneettccaallllss..ccoomm::33447788,
              ssttuunn..sscchhlluunndd..ddee::33447788,     ssttuunn..ssiippggaattee..nneett::1100000000,      ssttuunn..ssiipp‐‐
              ggaattee..nneett::33447788,                          ssttuunn..vvooiipp..aaeebbcc..ccoomm::33447788,
              ssttuunn..vvooiippaarroouunndd..ccoomm::33447788,  ssttuunn..vvooiippbbuusstteerr..ccoomm::33447788,  ssttuunn..vvooiipp‐‐
              ssttuunntt..ccoomm::33447788 and ssttuunn..xxtteenn..ccoomm::33447788 (this is the default).

       ssttuunnKKeeeeppaalliivveeSSttaarrttSS
              Interval in seconds between contacting a STUN server to maintain
              NAT mapping. Default is 2244 and you can set it to  00  to  disable
              contacting  STUN servers.  The interval is automatically reduced
              if needed, down to a minimum of _s_t_u_n_K_e_e_p_a_l_i_v_e_M_i_n_S.

       ssttuunnKKeeeeppaalliivveeMMiinnSS
              Minimum for the _s_t_u_n_K_e_e_p_a_l_i_v_e_S_t_a_r_t_S interval, in seconds.

       sseettLLoowwPPrriioorriittyy
              Syncthing will attempt to lower its process priority at startup.
              Specifically:  on Linux, set itself to a separate process group,
              set the niceness level of that process group to nine and the I/O
              priority  to  best  effort  level five; on other Unixes, set the
              process niceness level to nine; on Windows, set the process pri‐
              ority class to below normal. To disable this behavior, for exam‐
              ple to control process priority yourself as  part  of  launching
              Syncthing, set this option to ffaallssee.

       mmaaxxFFoollddeerrCCoonnccuurrrreennccyy
              This  option  controls  how  many folders may concurrently be in
              I/O-intensive operations such as syncing or scanning.  The mech‐
              anism is described in detail in a separate chapter.

       ccrraasshhRReeppoorrttiinnggUURRLL
              Server  URL  where  automatic  crash  reports  will  be  sent if
              enabled.

       ccrraasshhRReeppoorrttiinnggEEnnaabblleedd
              Switch to opt out from the automatic  crash  reporting  feature.
              Set  ffaallssee  to keep Syncthing from sending panic logs on serious
              troubles.  Defaults  to  ttrruuee,  to  help  the  developers  trou‐
              bleshoot.

       ddaattaabbaasseeTTuunniinngg
              Controls  how Syncthing uses the backend key-value database that
              stores the index data and other persistent data it  needs.   The
              available  options  and implications are explained in a separate
              chapter.

       mmaaxxCCoonnccuurrrreennttIInnccoommiinnggRReeqquueessttKKiiBB
              This limits how many bytes we have âin the airâ in the  form  of
              response data being read and processed.

       aannnnoouunncceeLLAANNAAddddrreesssseess
              Enable (the default) or disable announcing private (RFC1918) LAN
              IP addresses to global discovery.

       sseennddFFuullllIInnddeexxOOnnUUppggrraaddee
              Controls whether all index data is resent when  an  upgrade  has
              happened,  equivalent to starting Syncthing with ----rreesseett--ddeellttaass.
              This used to be the default behavior in older versions,  but  is
              mainly useful as a troubleshooting step and causes high database
              churn. The default is now ffaallssee.

       ffeeaattuurreeFFllaagg
              Feature flags are simple strings that, when added to the config‐
              uration, may unleash unfinished or still-in-development features
              to allow early user testing.  Any supported value will be  sepa‐
              rately  announced with the feature, so that regular users do not
              enable it by accident.

       ccoonnnneeccttiioonnLLiimmiittEEnnoouugghh
              The number of connections at which we stop trying to connect  to
              more  devices,  zero meaning no limit.  Does not affect incoming
              connections.  The mechanism is described in detail in a separate
              chapter.

       ccoonnnneeccttiioonnLLiimmiittMMaaxx
              The  maximum number of connections which we will allow in total,
              zero meaning no limit.  Affects incoming  connections  and  pre‐
              vents   attempting   outgoing  connections.   The  mechanism  is
              described in detail in a separate chapter.

       iinnsseeccuurreeAAlllloowwOOllddTTLLSSVVeerrssiioonnss
              Only for compatibility with old versions of Syncthing on  remote
              devices,      as      detailed     in     /advanced/option-inse‐
              cure-allow-old-tls-versions.

DDEEFFAAUULLTTSS EELLEEMMEENNTT
          <defaults>
              <folder id="" label="" path="~" type="sendreceive" rescanIntervalS="3600" fsWatcherEnabled="true" fsWatcherDelayS="10" ignorePerms="false" autoNormalize="true">
                  <filesystemType>basic</filesystemType>
                  <device id="S7UKX27-GI7ZTXS-GC6RKUA-7AJGZ44-C6NAYEB-HSKTJQK-KJHU2NO-CWV7EQW" introducedBy="">
                      <encryptionPassword></encryptionPassword>
                  </device>
                  <minDiskFree unit="%">1</minDiskFree>
                  <versioning>
                      <cleanupIntervalS>3600</cleanupIntervalS>
                      <fsPath></fsPath>
                      <fsType>basic</fsType>
                  </versioning>
                  <copiers>0</copiers>
                  <pullerMaxPendingKiB>0</pullerMaxPendingKiB>
                  <hashers>0</hashers>
                  <order>random</order>
                  <ignoreDelete>false</ignoreDelete>
                  <scanProgressIntervalS>0</scanProgressIntervalS>
                  <pullerPauseS>0</pullerPauseS>
                  <maxConflicts>10</maxConflicts>
                  <disableSparseFiles>false</disableSparseFiles>
                  <disableTempIndexes>false</disableTempIndexes>
                  <paused>false</paused>
                  <weakHashThresholdPct>25</weakHashThresholdPct>
                  <markerName>.stfolder</markerName>
                  <copyOwnershipFromParent>false</copyOwnershipFromParent>
                  <modTimeWindowS>0</modTimeWindowS>
                  <maxConcurrentWrites>2</maxConcurrentWrites>
                  <disableFsync>false</disableFsync>
                  <blockPullOrder>standard</blockPullOrder>
                  <copyRangeMethod>standard</copyRangeMethod>
                  <caseSensitiveFS>false</caseSensitiveFS>
                  <junctionsAsDirs>false</junctionsAsDirs>
              </folder>
              <device id="" compression="metadata" introducer="false" skipIntroductionRemovals="false" introducedBy="">
                  <address>dynamic</address>
                  <paused>false</paused>
                  <autoAcceptFolders>false</autoAcceptFolders>
                  <maxSendKbps>0</maxSendKbps>
                  <maxRecvKbps>0</maxRecvKbps>
                  <maxRequestKiB>0</maxRequestKiB>
                  <untrusted>false</untrusted>
                  <remoteGUIPort>0</remoteGUIPort>
              </device>
          </defaults>

       The ddeeffaauullttss element describes a template for newly  added  device  and
       folder  options.  These will be used when adding a new remote device or
       folder, either through the GUI or the command line interface.  The fol‐
       lowing child elements can be present in the ddeeffaauullttss element:

       ddeevviiccee Template for a ddeevviiccee element, with the same internal structure.
              Any fields here will be used for a newly  added  remote  device.
              The iidd attribute is meaningless in this context.

       ffoollddeerr Template for a ffoollddeerr element, with the same internal structure.
              Any fields here will be used for a newly  added  shared  folder.
              The iidd attribute is meaningless in this context.

              The  UI  will propose to create new folders at the path given in
              the ppaatthh attribute (used to be ddeeffaauullttFFoollddeerrPPaatthh under ooppttiioonnss).
              It  also applies to folders automatically accepted from a remote
              device.

              Even sharing with other remote devices can be done in  the  tem‐
              plate  by including the appropriate _f_o_l_d_e_r_._d_e_v_i_c_e element under‐
              neath.

   LLiisstteenn AAddddrreesssseess
       The following address  types  are  accepted  in  sync  protocol  listen
       addresses.   If you want Syncthing to listen on multiple addresses, you
       can either: add multiple <<lliisstteennAAddddrreessss>> tags in the configuration file
       or enter several addresses separated by commas in the GUI.

       DDeeffaauulltt lliisstteenn aaddddrreesssseess ((ddeeffaauulltt))
              This  is equivalent to ttccpp::////00..00..00..00::2222000000, qquuiicc::////00..00..00..00::2222000000
              and ddyynnaammiicc++hhttttppss::////rreellaayyss..ssyynncctthhiinngg..nneett//eennddppooiinntt.

       TTCCPP wwiillddccaarrdd aanndd ppoorrtt ((ttccpp::////00..00..00..00::2222000000,, ttccpp::////::2222000000))
              These are equivalent and will result in Syncthing  listening  on
              all interfaces, IPv4 and IPv6, on the specified port.

       TTCCPP IIPPvv44 wwiillddccaarrdd aanndd ppoorrtt ((ttccpp44::////00..00..00..00::2222000000,, ttccpp44::////::2222000000))
              These  are  equivalent and will result in Syncthing listening on
              all interfaces via IPv4 only.

       TTCCPP IIPPvv44 aaddddrreessss aanndd ppoorrtt ((ttccpp44::////119922..00..22..11::2222000000))
              This results in Syncthing listening on the specified address and
              port, IPv4 only.

       TTCCPP IIPPvv66 wwiillddccaarrdd aanndd ppoorrtt ((ttccpp66::////[[::::]]::2222000000,, ttccpp66::////::2222000000))
              These  are  equivalent and will result in Syncthing listening on
              all interfaces via IPv6 only.

       TTCCPP IIPPvv66 aaddddrreessss aanndd ppoorrtt ((ttccpp66::////[[22000011::ddbb88::::4422]]::2222000000))
              This results in Syncthing listening on the specified address and
              port, IPv6 only.

       QQUUIICC aaddddrreessss aanndd ppoorrtt ((ee..gg.. qquuiicc::////00..00..00..00::2222000000))
              Syntax is the same as for TCP, also qquuiicc44 and qquuiicc66 can be used.

       SSttaattiicc rreellaayy aaddddrreessss ((rreellaayy::////119922..00..22..4422::2222006677??iidd==aabbccdd112233......))
              Syncthing  will  connect  to and listen for incoming connections
              via the specified relay address.

   TTooddoo
       Document available URL parameters.

       DDyynnaammiicc rreellaayy ppooooll ((ddyynnaammiicc++hhttttppss::////119922..00..22..4422//rreellaayyss))
              Syncthing will fetch the specified HTTPS URL,  parse  it  for  a
              JSON  payload  describing relays, select a relay from the avail‐
              able ones and listen via that as if specified as a static  relay
              above.

   TTooddoo
       Document available URL parameters.

SSYYNNCCIINNGG CCOONNFFIIGGUURRAATTIIOONN FFIILLEESS
       Syncing configuration files between devices (such that multiple devices
       are using the same configuration files) can cause issues. This is  easy
       to do accidentally if you sync your home folder between devices. A com‐
       mon symptom of syncing configuration files is  two  devices  ending  up
       with the same Device ID.

       If  you want to use Syncthing to backup your configuration files, it is
       recommended that the files you are backing up are in a  folder-sendonly
       to prevent other devices from overwriting the per device configuration.
       The folder on the remote device(s) should not be used as  configuration
       for the remote devices.

       If  youâd  like to sync your home folder in non-send only mode, you may
       add the folder that stores the configuration files to the ignore  list.
       If  youâd  also  like  to  backup your configuration files, add another
       folder in send only mode for just the configuration folder.

AAUUTTHHOORR
       The Syncthing Authors

CCOOPPYYRRIIGGHHTT
       2014-2019, The Syncthing Authors



v1.19.2                          Apr 05, 2022              SYNCTHING-CONFIG(5)
