Skip to content

Commit 9a353ab

Browse files
authored
Updated Documentation
1 parent 7ec4a93 commit 9a353ab

File tree

1 file changed

+78
-1
lines changed

1 file changed

+78
-1
lines changed

README.md

Lines changed: 78 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,78 @@
1-
# syncplayserver-docker
1+
# Syncplay Server - Docker
2+
3+
A docker image for running a [Syncplay](https://syncplay.pl/) server. Pulls the most up-to-date Syncplay build.
4+
5+
[![syncplay](https://raw.githubusercontent.com/Syncplay/syncplay/master/syncplay/resources/hicolor/128x128/apps/syncplay.png)](https://syncplay.pl/)
6+
7+
## Useage
8+
9+
```
10+
docker run -d \
11+
-p 8999:8999 \
12+
-e SALT=E1F53135E559C253 \
13+
-e PORT=8999 \
14+
-e PASSWORD=CHANGEME \
15+
-e ISOLATE=FALSE \
16+
-e DISABLEREADY=FALSE \
17+
-e DISABLECHAT=FALSE \
18+
-e MAXCHATLENGTH=120 \
19+
-e MAXUNAMELENGTH=20 \
20+
-e MOTD=TRUE \
21+
-e TLS=TRUE \
22+
-v /path/to/motd.txt:/motd.txt \
23+
-v /path/to/certs:/certs \
24+
sushiman42/syncplayserver-docker
25+
```
26+
27+
## [Docker Compose](https://github.com/Sushiman42/syncplayserver-docker/blob/main/docker-compose.yml) (Recommended)
28+
29+
```
30+
version: "3"
31+
services:
32+
syncplay:
33+
image: sushiman42/syncplayserver-docker:latest
34+
restart: always
35+
ports:
36+
- 8999:8999
37+
environment:
38+
- SALT=E1F53135E559C253
39+
- PORT=8999
40+
- PASSWORD=CHANGEME
41+
- ISOLATE=FALSE
42+
- DISABLEREADY=FALSE
43+
- DISABLECHAT=FALSE
44+
- MAXCHATLENGTH=120
45+
- MAXUNAMELENGTH=20
46+
- MOTD=TRUE
47+
- TLS=TRUE
48+
volumes:
49+
- /path/to/motd.txt:/motd.txt
50+
- /path/to/certs:/certs
51+
```
52+
53+
## Parameters
54+
55+
See the [Syncplay server guide](https://syncplay.pl/guide/server/) for more detailed explanations of these parameters.
56+
57+
| Parameter | Function |
58+
| :----: | --- |
59+
| `-p 8999` | Change this as well as -e PORT for a nonstandard port mapping |
60+
| `-e SALT=<salt string>` | Optional, remove for no salt |
61+
| `-e PORT=8999` | Default is 8999, change along with -p for nonstandard port mapping |
62+
| `-e PASSWORD=<password string>` | Optional, remove to disable server password |
63+
| `-e ISOLATE=FALSE` | Set to TRUE for **room isolation** |
64+
| `-e DISABLEREADY=FALSE` | Set to TRUE to disable the readiness indicator feature |
65+
| `-e DISABLECHAT=FALSE` | Set to TRUE to disable chat |
66+
| `-e MAXCHATLENGTH=<x>` | Optional, remove to disable chat char. limit |
67+
| `-e MAXUNAMELENGTH=<x>` | Optional, remove to disable username char. limit |
68+
| `-e MOTD=FALSE` | Optional, set to TRUE to use an MOTD file |
69+
| `-e TLS=FALSE` | Optional, set to TRUE to use TLS CERTS |
70+
| `-v /path/to/motd.txt:/motd.txt` | Specify path to MOTD file if set to TRUE above |
71+
| `-v /path/to/certs:/certs` | Specify path to certs folder if set to TRUE above (visit [letsencrypt](https://letsencrypt.org/) for certs) |
72+
73+
## Possible updates
74+
Only if I feel motivated
75+
76+
* UID/GID support
77+
* Healthcheck implementation
78+
* ctrl-c sigkill when inside container

0 commit comments

Comments
 (0)