mirror of
https://github.com/LizardByte/Sunshine.git
synced 2024-11-18 11:10:04 +00:00
dcdd716a57
* update docker * remove legacy docker builds * update docker documentation * update docker build Co-authored-by: ABeltramo <beltramo.ale@gmail.com>
97 lines
3.4 KiB
Markdown
97 lines
3.4 KiB
Markdown
# Docker
|
|
|
|
## Build your own containers
|
|
This image provides a method for you to easily use the latest Sunshine release in your own docker projects. It is not
|
|
intended to use as a standalone container at this point, and should be considered experimental.
|
|
|
|
```dockerfile
|
|
FROM lizardbyte/sunshine
|
|
|
|
# install Steam, Wayland, etc.
|
|
|
|
ENTRYPOINT steam && sunshine
|
|
```
|
|
|
|
## Where used
|
|
This is a list of docker projects using Sunshine. Something missing? Let us know about it!
|
|
|
|
- [Games on Whales](https://games-on-whales.github.io)
|
|
|
|
## Port and Volume mappings
|
|
Examples are below of the required mappings. The configuration file will be saved to `/config` in the container.
|
|
|
|
### Using docker run
|
|
Create and run the container (substitute your `<values>`):
|
|
|
|
```bash
|
|
docker run -d \
|
|
--name=<image_name> \
|
|
--restart=unless-stopped
|
|
-e PUID=<uid> \
|
|
-e PGID=<gid> \
|
|
-e TZ=<timezone> \
|
|
-v <path to data>:/config \
|
|
-p 47984-47990:47984-47990/tcp \
|
|
-p 48010:48010 \
|
|
-p 47998-48000:47998-48000/udp \
|
|
<image>
|
|
```
|
|
|
|
### Using docker-compose
|
|
Create a `docker-compose.yml` file with the following contents (substitute your `<values>`):
|
|
|
|
```yaml
|
|
version: '3'
|
|
services:
|
|
<image_name>:
|
|
image: <image>
|
|
container_name: sunshine
|
|
restart: unless-stopped
|
|
volumes:
|
|
- <path to data>:/config
|
|
environment:
|
|
- PUID=<uid>
|
|
- PGID=<gid>
|
|
- TZ=<timezone>
|
|
ports:
|
|
- "47984-47990:47984-47990/tcp"
|
|
- "48010:48010"
|
|
- "47998-48000:47998-48000/udp"
|
|
```
|
|
|
|
### Parameters
|
|
You must substitute the `<values>` with your own settings.
|
|
|
|
Parameters are split into two halves separated by a colon. The left side represents the host and the right side the
|
|
container.
|
|
|
|
**Example:** `-p external:internal` - This shows the port mapping from internal to external of the container.
|
|
Therefore `-p 47990:47990` would expose port `47990` from inside the container to be accessible from the host's IP on
|
|
port `47990` (e.g. `http://<host_ip>:47990`). The internal port must be `47990`, but the external port may be changed
|
|
(e.g. `-p 8080:47990`). All the ports listed in the `docker run` and `docker-compose` examples are required.
|
|
|
|
|
|
| Parameter | Function | Example Value | Required |
|
|
|-----------------------------|---------------------------|--------------------|----------|
|
|
| `-p <port>:47990` | Web UI Port | `47990` | True |
|
|
| `-v <path to data>:/config` | Volume mapping | `/home/sunshine` | True |
|
|
| `-e PUID=<uid>` | User ID | `1001` | False |
|
|
| `-e PGID=<gid>` | Group ID | `1001` | False |
|
|
| `-e TZ=<timezone>` | Lookup TZ value [here][1] | `America/New_York` | False |
|
|
|
|
[1]: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
|
|
|
|
#### User / Group Identifiers:
|
|
When using data volumes (-v flags) permissions issues can arise between the host OS and the container. To avoid this
|
|
issue you can specify the user PUID and group PGID. Ensure the data volume directory on the host is owned by the same
|
|
user you specify.
|
|
|
|
In this instance `PUID=1001` and `PGID=1001`. To find yours use id user as below:
|
|
|
|
```bash
|
|
$ id dockeruser
|
|
uid=1001(dockeruser) gid=1001(dockergroup) groups=1001(dockergroup)
|
|
```
|
|
|
|
If you want to change the PUID or PGID after the image has been built, it will require rebuilding the image.
|