Remote Command Plugin in Docker | Realityscan Documentation

To register the plugin and start the server, we need to use -delegateTo to run the server

Sample Dockerfile (Remote Command Plugin)

You may adjust paths and filenames as needed.

Command Line

# Dockerfile: ubuntu-firefox (robust download + x11-apps + bzip2/xz support)
FROM ubuntu:22.04

ENV DEBIAN_FRONTEND=noninteractive

# Install required packages (curl/wget, bzip2/xz support, x11-apps and GTK deps)
RUN apt-get update && \
    apt-get install -y --no-install-recommends \
      curl wget bzip2 xz-utils x11-apps ca-certificates \
      libgtk-3-0 libdbus-glib-1-2 libxt6 \

Sample entrypoint.sh

sleep 10 is required because RS needs time to load fonts and plugins before delegation.

Command Line

#!/usr/bin/env bash
# set -e
/opt/realityscan/bin/wine --start "$RS_EXE" -setInstanceName $CON_NAME $RS_ARGS &
pid1=$!
sleep 10
/opt/realityscan/bin/wine --start "$RS_EXE" -delegateTo $CON_NAME $RSREMOTE_ARGS
wait $pid1

#!/usr/bin/env bash
# set -e
/opt/realityscan/bin/wine --start "$RS_EXE" -setInstanceName $CON_NAME $RS_ARGS &
pid1=$!
sleep 10
/opt/realityscan/bin/wine --start "$RS_EXE" -delegateTo $CON_NAME $RSREMOTE_ARGS
wait $pid1

Running the Remote Server Container

Command Line

docker run --rm -it --gpus all \
  -e DISPLAY=$DISPLAY -v /tmp/.X11-unix:/tmp/.X11-unix \
  -v /home/localuser/Downloads/:/mnt/host \
  -v /etc/vulkan/icd.d:/usr/share/vulkan/icd.d:ro \
  -e NVIDIA_DRIVER_CAPABILITIES=all --device /dev/dri \
  -e RSREMOTE_ARGS="-RsRemoteStartREST http://0.0.0.0:1234 -tag TEST_TAG" \
  -p 1234:1234 \
  ubuntu-realityscan

docker run --rm -it --gpus all \
  -e DISPLAY=$DISPLAY -v /tmp/.X11-unix:/tmp/.X11-unix \
  -v /home/localuser/Downloads/:/mnt/host \
  -v /etc/vulkan/icd.d:/usr/share/vulkan/icd.d:ro \
  -e NVIDIA_DRIVER_CAPABILITIES=all --device /dev/dri \
  -e RSREMOTE_ARGS="-RsRemoteStartREST http://0.0.0.0:1234 -tag TEST_TAG" \
  -p 1234:1234 \
  ubuntu-realityscan

Notes:

RSREMOTE_ARGS was redefined at runtime.
You can override other environment variables as well (RS_ARGS, RS_EXE, CON_NAME).
-p 1234:1234 maps container REST server to host.
--rm removes container after exit.
CON_NAME may be used as a session ID in production.
-v /home/localuser/Downloads/:/mnt/host Optionally share and map a host folder to the container