|
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 | +[](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