aboutsummaryrefslogtreecommitdiff
path: root/README-Docker.md
diff options
context:
space:
mode:
authorJakob Borg <jakob@kastelo.net>2018-04-09 10:48:37 +0200
committerGitHub <noreply@github.com>2018-04-09 10:48:37 +0200
commite9c6795ef8f7f3bff923fb35e3fef1c764b133ce (patch)
treeb2ebaf9334684548889e08e59223390d49bc730b /README-Docker.md
parentafb27f7f02958872154fa67b61dced46551fe01b (diff)
downloadsyncthing-e9c6795ef8f7f3bff923fb35e3fef1c764b133ce.tar.gz
syncthing-e9c6795ef8f7f3bff923fb35e3fef1c764b133ce.zip
docker: Add README from old Docker repo (fixes #4868) (#4869)
With slight modifications
Diffstat (limited to 'README-Docker.md')
-rw-r--r--README-Docker.md43
1 files changed, 43 insertions, 0 deletions
diff --git a/README-Docker.md b/README-Docker.md
new file mode 100644
index 000000000..fc6504ccd
--- /dev/null
+++ b/README-Docker.md
@@ -0,0 +1,43 @@
+# Docker Container for Syncthing
+
+Use the Dockerfile in this repo, or pull the `syncthing/syncthing` image
+from Docker Hub. Use volumes to have the synchronized files available on the
+host.
+
+The exposed volumes are by default:
+
+ /var/syncthing/config - the configuration and index directory into the Container
+ /var/syncthing - the default sync folder into the Container
+
+You can add more folders and map them as you prefer.
+
+Note that Syncthing runs as UID 1000 in the container. This UID must have
+permission to read and modify the files in the containers.
+
+Example usage:
+
+```
+$ docker pull syncthing/syncthing
+$ docker run -p 8384:8384 -p 22000:22000 \
+ -v /wherever/st-cfg:/var/syncthing/config \
+ -v /wherever/st-sync:/var/syncthing \
+ syncthing/syncthing:latest
+```
+
+Note that local device discovery will not work with the above command resulting
+in poor local transfer rates if local device addresses are not manually
+configured.
+
+To allow local discovery, the docker host network can be used instead:
+
+```
+$ docker pull syncthing/syncthing
+$ docker run --network=host \
+ -v /wherever/st-cfg:/var/syncthing/config \
+ -v /wherever/st-sync:/var/syncthing \
+ syncthing/syncthing:latest
+```
+
+Be aware that syncthing alone is now in control of what interfaces and ports it
+listens on. You can edit the syncthing configuration to change the defaults if
+there are conflicts.