User Tools

Site Tools


syncthing

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Last revision Both sides next revision
syncthing [2020/04/07 12:09]
sdbs [CPU]
syncthing [2020/04/07 12:46]
sdbs [Send / Receive Only]
Line 17: Line 17:
 Its //primary// use-case is when a single person has more computers, and wants to keep some folders synchronized on all of them. Its //primary// use-case is when a single person has more computers, and wants to keep some folders synchronized on all of them.
  
-What we use it for, however, is general data sharing - there's semi-public Syncthing folders (listed below). It works well for common (audio, video) files and projects, for sharing essential software packages, and for community-powered backups as well. ** For local sync there is no need for internet, local network is enough.**+=== /-\ use-case ===
  
 +What we use it for, however, is general data sharing - there's semi-public Syncthing folders (listed below). It works well for common (audio, video) files and projects, for sharing essential software packages, and for community-powered backups as well. Also for local (LAN) sync - there is no need for internet, local network is enough.
  
 +**WARNING: Because Syncthing wasn't really meant for this sort of use, it requires a bit of carefulness on part of everyone involved. There's no authentication, no permissions, and by default no [[syncthing#versioning|file versioning]]. It's not too easy to mess up accidentally, but if you do, it's not pretty.**
 ===== How? ===== ===== How? =====
  
Line 32: Line 34:
  
 ==== Send / Receive Only ==== ==== Send / Receive Only ====
-Send Receive Only limit the folder/file changes either received or sent from the current machine.+Send Only & Receive Only limit the folder/file changes either received or sent from the current machine.
  
 === Send Only Folder === === Send Only Folder ===
Line 69: Line 71:
  
 ===== QnA ===== ===== QnA =====
 +
 +==== Common Gotchas ====
 +
 +=== folder marker missing // .stfolder blues ===
 +
 +Syncthing marks each synced folder with an empty, hidden directory in that folder, called ''.stfolder''. This tells Syncthing everything is in order, and this is really the folder which it should be modifying/uploading changes from.
 +
 +If that (empty) folder is deleted, Syncthing will vomit with a similar error message:
 +
 +  2020-04-02 21:12:50: Error on folder "KSX_OUT" (ksx-out): folder marker missing (this indicates potential data loss, search docs/forum to get information about how to proceed)
 +
 +This can happen for a couple of reasons:
 +
 +  * Actual potential data loss - you should [[S.M.A.R.T.|check your disks]] and remember where you keep your backups.
 +  * Some sort of "empty folder cleanup" thing ran on the folder and deleted ''.stfolder''.
 +    * If that's the case, and it's really the only thing that happened, it's safe to simply re-create ''.stfolder'' (by right-clicking and selecting "New Folder") in that directory.
 +    * If not, and you still do this, you've just successfully corrupted everyone else's Syncthing folders with your broken data.
 +  * Entire folder is missing. See [[syncthing#moving_syncthing_folders|Moving Syncthing Folders?]]
 ==== CPU ==== ==== CPU ====
  
Line 79: Line 99:
 ==== Whitelisting files ==== ==== Whitelisting files ====
    
 +FIXME
 ==== Moving syncthing folders? ==== ==== Moving syncthing folders? ====
  
- +FIXME
 ===== Semi-public Syncthing folders ===== ===== Semi-public Syncthing folders =====
  
 See [[internal:syncthing]] See [[internal:syncthing]]
syncthing.txt · Last modified: 2020/10/04 12:26 by sdbs