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
syncthing [2020/04/07 12:09]
sdbs [CPU]
syncthing [2020/10/04 12:26] (current)
sdbs [External HDDs] add link
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 65: Line 67:
  
 On windows it helps to set fixed drive letter to your hardrive, so there are no mismatches. On windows it helps to set fixed drive letter to your hardrive, so there are no mismatches.
 +
 +
 >When assigning your drive letter, make sure to choose a letter toward the end of the alphabet list. For example, X, Y, or Z — otherwise Windows has the tendency to eventually assign a different letter. Also, keep in mind that it will only be the assigned letter on the computer you changed it on. If you take your external drive to a different PC, Windows will give it a different dynamic letter.((From https://www.groovypost.com/howto/assign-permanent-letter-removable-usb-drive-windows/)) >When assigning your drive letter, make sure to choose a letter toward the end of the alphabet list. For example, X, Y, or Z — otherwise Windows has the tendency to eventually assign a different letter. Also, keep in mind that it will only be the assigned letter on the computer you changed it on. If you take your external drive to a different PC, Windows will give it a different dynamic letter.((From https://www.groovypost.com/howto/assign-permanent-letter-removable-usb-drive-windows/))
  
  
 +https://www.groovypost.com/howto/assign-permanent-letter-removable-usb-drive-windows/
 ===== 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 102:
 ==== 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.1586254182.txt.gz · Last modified: 2020/04/07 12:09 by sdbs