Skip to content

Commit fcde29e

Browse files
committed
update info about web gui settings
1 parent 1f4296d commit fcde29e

File tree

1 file changed

+62
-5
lines changed

1 file changed

+62
-5
lines changed

README.md

Lines changed: 62 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,24 +1,81 @@
11
BitTorrent Sync using Resilio Sync
22
==================================
33

4+
This is a small container [![](https://images.microbadger.com/badges/image/nimmis/resilio-sync.svg)](https://microbadger.com/images/nimmis/resilio-sync "Get your own image badge on microbadger.com") using Resilio Sync client to syncronize data between clients.
5+
46
Sync skips the cloud and finds the shortest path between devices when transferring data. No Cloud. No uploading to third party servers. Just fast, simple file syncing.
57

6-
Based on my alpine micro container with glibc [nimmis/alpine-glibc](https://registry.hub.docker.com/u/nimmis/alpine-glibc/), size just under 26 Mb
8+
Based on my alpine micro container with glibc [![](https://images.microbadger.com/badges/image/nimmis/alpine-glibc.svg)](https://microbadger.com/images/nimmis/alpine-glibc "Get your own image badge on microbadger.com") please visit [nimmis/alpine-glibc](https://registry.hub.docker.com/u/nimmis/alpine-glibc/) for more information.
9+
10+
This container can run in two different mode:
11+
12+
* web gui mode, all configuration done thru a web interface
13+
* sync mode, sync predefined directory with secret key supplied or generated
14+
15+
# Global settings
16+
17+
These setting applies to both web gui and sync mode
18+
19+
### RSLSYNC_NAME
20+
21+
This variable defines the name shown on other nodes, if not defined it will get the name shown with the command *hostname*
22+
23+
This will start a container with then name **database**
24+
25+
docker run -d -e RSLSYNC_NAME=database -p 33333:33333 nimmis/resilio-sync
26+
27+
### syncing local files
28+
29+
Inside the container the /data is the default sync directory, to link this to a local file system you can use the **-v** flag
30+
31+
To sync the the directory /home/joe you can run
32+
33+
docker run -d -v /home/joe:/data -p 33333:33333 nimmis/resilio-sync
34+
35+
# web gui mode
36+
37+
This setting activates a web gui to configure the Resilio Sync client
38+
39+
### RSLSYNC_USER
40+
41+
This variable defines the username used to login to the web interface.
42+
43+
**Setting this variable activates the web gui mode.**
44+
45+
### RSLSYNC_PASS
46+
47+
This variable defines the password used to login to the web interface. If this variable is not defined or empty an random password will be generated. The password can be retrieved from the log.
48+
49+
docker run -d -e RSLSYNC_USER=joe --name sync -p 8888:8888 -p 33333:33333 nimmis/resilio-sync
50+
docker logs sync
51+
Run scripts in /etc/run_once
52+
WEBUI mode activated
53+
RSLSYNC_PASS not set, password generated, use M2FlMjNkOG as password
54+
55+
In this case you should login with user **joe** and password **M2FlMjNkOG**
56+
57+
# Sync mode
58+
59+
The sync mode version is made for syncing one directory only (you can manualy configure multiple directories), each directory (or sync point) need a uniq secret key. If you need several different directories synced, start a container for each directory
60+
61+
### RSLSYNC_SECRET
762

63+
This variable contains the secret key fore this directory, if empty or missing a new secret key is generated. This key can then be used to start more sync klient for the data.
864

9-
## run container on first sync node
65+
### Run container on first sync node
1066

1167
The first nod creates a uniq secret used to sync all nodes, map the directory you wan't to be syncronized to /data in the container.
1268

1369
Example synk the directory /home/me/data on first nod giving it the name syncnode
1470

15-
docker run -d -v /home/me/data:/data --name syncnode nimmis/resilio-sync
71+
docker run -d -v /home/me/data:/data --name sync -p 33333:33333 nimmis/resilio-sync
1672

1773

1874
to see the secret code to use on the other nodes, look at the log-output from the container
1975

20-
> docker logs -f syncnode
76+
> docker logs -f sync
2177
Run scripts in /etc/run_once
78+
non-WEBUI mode activated, /data is synced
2279
add -e RSLSYNC_SECRET=AF2INNKYP672IGIIDTDWWVUBGP2AQRFKX to your other nodes to sync
2380
Run scripts is /etc/run_always
2481
Started runsvdir, PID is 14
@@ -40,7 +97,7 @@ first container but all sub-folders will be the same. So starting a second sync
4097
on another docker machine using local directory /home/you/sync-backup and using the secret
4198
key obtained from the first sync node example above
4299

43-
docker run -d -v /home/you/sync-backup:/data --name syncnode2 -e RSLSYNC_SECRET=AF2INNKYP672IGIIDTDWWVUBGP2AQRFKX nimmis/resilio-sync
100+
docker run -d -v /home/you/sync-backup:/data --name syncnode2 -P 33333:33333 -e RSLSYNC_SECRET=AF2INNKYP672IGIIDTDWWVUBGP2AQRFKX nimmis/resilio-sync
44101

45102
NOTE!!!!! DO NOT USE the secret key in this example, use the one you got from the first sync node run.
46103

0 commit comments

Comments
 (0)