Public | Automated Build

Last pushed: 3 months ago
Short Description
Syncthing Docker image
Full Description


Syncthing Docker image

How to run

Simpliest way to run this container is by using docker-compose.yml file. Simply run:

docker-compose up -d

Then access Syncthing Web UI at http://localhost:8384/.

To update the container, run:

docker-compose pull
docker-compose up -d

You can also start the container manually without using Docker Compose:

# Container requires 2 volumes: for config and for data.

docker run -d \
    --name $CONTAINER_NAME \
    --restart always \
    -p 8384:8384 -p 22000:22000 -p 21027:21027/udp \
    -v $CONFIG_VOLUME:/home/syncthing/.config/syncthing \
    -v $DATA_VOLUME:/home/syncthing/Sync \

Note: --restart always (or --restart on-failure or --restart unless-stopped) is required because Syncthing restarts itself during auto-update. Without this option container just stops after first update.

Enabling HTTPS for Web UI

The image itself tends to be minimal and doesn't provide any HTTPS functionality. If you want to have a SSL connection between your browser and Syncthing Web UI, you need to put a proxy container that will handle HTTPS connections.

The easiest way to do it is by using Let's Encrypt certifcates and 3 additional containers: official Nginx image, jwilder/docker-gen image to auto-generate Nginx configs and jrcs/letsencrypt-nginx-proxy-companion image to auto-generate/auto-renew SSL certificates. To orchestrate all containers, we'll use docker-compose-https.yml file:


# before launching, we need to prepare 2 docker volumes:
docker volume create --driver local --name certs
docker volume create --driver local --name nginx-templates

# download nginx template into "nginx-templates" volume
docker run --rm -v nginx-templates:/tmp/nginx-templates alpine /bin/sh -c 'apk add --no-cache curl ca-certificates && curl -o /tmp/nginx-templates/nginx.tmpl'

# Setup env vars that will be used by Docker Compose file.
# SYNCTHING_HOSTNAME must be accessible from outside, otherwise SSL certificate won't be generated.
# Make sure port 80 is open and the domain name is resolvable.
# (this is an example, replace this with real values)

docker-compose -f docker-compose-https.yml up -d

Make sure you set LETSENCRYPT_EMAIL and LETSENCRYPT_EMAIL env vars before running Docker Compose commands. You can also edit docker-compose-https.yml and replace these vars with real values.

Docker Pull Command
Source Repository

Comments (5)
3 months ago


Loving this docker image of syncthing. Works very well. I'm wondering if there is any possibility to add syncthing-inotify as default into this image, or at least provide a label which include it? syncthing-inotify makes sure detects files that is changed on disk and thus reduce the amount of rescans needed.

a year ago

Is it possible to change permissions for mounted volume? Files in Sync have default permissions set to
drwx------ 1 user user. It would be great to be able to modify owner and permissions.

2 years ago

Why are you upgrading anything inside of a docker container why not just pull an upgraded copy and replace it.

2 years ago

New version is able to do auto-upgrade. To handle process restart, add --restart always flag to docker run command

2 years ago


I am a little disapointed as the docker is fine except the binary is in / and so cannot upgrade itself :(
The binary use the user syncthing who cannot create files inside /

The binary should be put in /usr/local/bin (for example) so it would be able to download update and upgrade.

Take into account that upgrading restart the process and so stop the docker. Maybe with supervisord it is possible to avoid this behavior.