Skip to content

Files

Latest commit

 

History

History
71 lines (48 loc) · 5.53 KB

File metadata and controls

71 lines (48 loc) · 5.53 KB

syncthing-relay-discovery-logging

Docker Container for the global relay server for the http://syncthing.net/ project. I build the container because ther is no official one. This build is listening on the gihub project of the relay server and gets updated whenever there is a code change. relaysrv GitHub repo and dicosrv GitHub repo. The container is intendet for people who like to roll their own private syncthing "cloud".

The files for this container can be found at my GitHub repo

About the Container

This build is based on t4skforce's syncthing-relay-discovery docker image and installs the latests successful build of the syncthing relay server, discovery server and enables logging of both.

How to use this image

docker run --name syncthing-relay -d -p 22067:22067 --restart=always seancrites/syncthing-relay-discovery-logging:latest

This will store the certificates and all of the data in /home/syncthing/. You will probably want to make at least the certificate folder a persistent volume (recommended):

docker run --name syncthing-relay -d -p 22067:22067 -v /your/home:/home/syncthing/certs --restart=always seancrites/syncthing-relay-discovery-logging:latest

If you already have certificates generated and want to use them and protect the folder from being changed by the docker images use the following command:

docker run --name syncthing-relay -d -p 22067:22067 -v /your/home:/home/syncthing/certs:ro --restart=always seancrites/syncthing-relay-discovery-logging:latest

Creating cert directory and setting permissions (docker process is required to have access):

mkdir -p /your/home/certs
chown -R 1000:1000 /your/home/certs

Container Configuration

There are several configuarion options available. The options are configurable via environment variables (docker default):

Example enabling debug mode:

export RELAY_OPTS='-debug'
export DISCO_OPTS='-debug'
docker run --name syncthing-relay-discovery -d -p 22067:22067 -p 22026:22026 --restart=always seancrites/syncthing-relay-discovery-logging:latest

or

docker run --name syncthing-relay-discovery -d -p 22067:22067 -p 22026:22026 -e RELAY_OPTS='-debug' -e DISCO_OPTS='-debug' --restart=always seancrites/syncthing-relay-discovery-logging:latest

Options

  • DEBUG: enable debugging (true/false) / default:true

Syncthing-Relay Server

  • RATE_GLOBAL: global maximum speed for transfer / default:10000000 = 10mbps
  • RATE_SESSION: maximum speed for transfer per session / default:5000 = 500kbps
  • TIMEOUT_MSG: change message timeout / default: 1m45s
  • TIMEOUT_NET: change net timeout / default: 3m30s
  • PING_INT: change ping timeout / default: 1m15s
  • PROVIDED_BY: change provided by string / default:"syncthing-relay"
  • RELAY_PORT: port the relay server listens on / default:22067
  • STATUS_PORT: disable by default to enable it add -d 22070:22070 to you docker run command / default:22070
  • POOLS: leave empty for private relay use "https://relays.syncthing.net/endpoint" for public relay / default: ""
  • RELAY_OPTS: to provide addition options not configurable via env variables above / default: ""
    • example: -e RELAY_OPTS='-ext-address=:443'

Syncthing-Discovery Server

  • DISCO_PORT: port the discovery server listens on / default:22026
  • DISCO_OPTS: to provide addition options not configurable via env variables above / default: ""
    • example: -e RELAY_OPTS='-metrics-listen=:19201'

Have a look at the current doc GitHub - relaysrv GitHub - discosrv