Docker#
Important note#
Starting with v0.18.0, tag names have changed. You may no longer use latest
, master
, vX.X.X
.
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.
ARG SUNSHINE_VERSION=latest
ARG SUNSHINE_OS=ubuntu-22.04
FROM lizardbyte/sunshine:${SUNSHINE_VERSION}-${SUNSHINE_OS}
# install Steam, Wayland, etc.
ENTRYPOINT steam && sunshine
SUNSHINE_VERSION#
latest
,master
,vX.X.X
nightly
commit hash
SUNSHINE_OS#
Sunshine images are available with the following tag suffixes, based on their respective base images.
archlinux
debian-bullseye
fedora-36
fedora-37
ubuntu-20.04
ubuntu-22.04
Where used#
This is a list of docker projects using Sunshine. Something missing? Let us know about it!
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>
):
docker run -d \
--device /dev/dri/ \
--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>
):
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"
Using podman run#
Create and run the container (substitute your <values>
):
podman run -d \
--device /dev/dri/ \
--name=<image_name> \
--restart=unless-stopped \
--userns=keep-id \
-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>
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 |
---|---|---|---|
|
Web UI Port |
|
True |
|
Volume mapping |
|
True |
|
User ID |
|
False |
|
Group ID |
|
False |
|
Lookup TZ value |
|
False |
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:
$ 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.
Supported Architectures#
Specifying lizardbyte/sunshine:latest-<SUNSHINE_OS>
or ghcr.io/lizardbyte/sunshine:latest-<SUNSHINE_OS>
should
retrieve the correct image for your architecture.
The architectures supported by these images are shown in the table below.
tag suffix |
amd64/x86_64 |
arm64/aarch64 |
---|---|---|
archlinux |
✅ |
❌ |
debian-bookworm |
✅ |
✅ |
debian-bullseye |
✅ |
✅ |
fedora-38 |
✅ |
✅ |
fedora-39 |
✅ |
✅ |
ubuntu-20.04 |
✅ |
✅ |
ubuntu-22.04 |
✅ |
✅ |