SlimeVR Docker

Run SlimeVR Server + Web GUI in Docker.

Quick Start

docker compose up -d --build
open http://localhost:8080

Stop:

docker compose down

What it does

sequenceDiagram
    participant User
    participant Nginx
    participant SlimeVR
    participant Tracker

    Note over SlimeVR: Starts, downloads latest version<br/>from GitHub automatically
    SlimeVR->>Tracker: Detect trackers via USB/HID
    SlimeVR->>Nginx: Copy GUI to /gui_mount
    User->>Nginx: GET /:8080
    Nginx-->>User: 302 → /?ip=<host_ip>
    User->>Nginx: GET /?ip=<host_ip>
    Nginx->>User: Serve SlimeVR Web GUI
    User->>SlimeVR: WebSocket connections
    Tracker->>SlimeVR: Tracking data (port 6969)

Loading

Architecture

Container	Purpose	Network
slimevr	Java server + tracker comms	host
nginx	Serves Web GUI	host

• slimevr: Downloads latest SlimeVR from GitHub, copies GUI to volume
• nginx: Serves GUI, auto-redirects with ?ip= parameter for WebSocket connection

Configuration

Create .env if you need custom values (all optional):

WEBGUI_PORT=8080
SLIMEVR_VERSION=latest

Without .env, defaults are used (port 8080, latest version).

Volumes

Volume	Purpose
slimevr-config	Persists vrconfig.yml
slimevr-gui	GUI assets (slimevr → nginx)

Ports

Port	Protocol	Purpose
6969	UDP	Tracker data
8080	TCP	Web GUI
21110	TCP	WebSocket VR Bridge
9000-9002	TCP/UDP	OSC
39539-39540	TCP/UDP	VMC

Update

docker compose up -d --build

Always downloads latest unless you set SLIMEVR_VERSION in .env.

Troubleshooting

# Check status
docker compose ps

# View logs
docker compose logs -f

# Full diagnostics
./slimevrctl doctor

Credits

• SlimeVR
• GUI from official SlimeVR releases

License

MIT