# Easy mode — host your own server > Built for non-technical hosts. If you can install Discord, you can do this. > > **On Linux or macOS?** This guide is for the Windows GUI launcher. > For headless hosting from a Linux box / a Mac / a VPS, see > [server-cli.md](server-cli.md). Joiners on those platforms are not > supported yet — Rec Room itself is a Windows game. DorkNet bundles everything you need to run a private Rec Room server on your own machine and hand a join code to your friends. The launcher is a single Windows app that: - runs the server, - opens a public tunnel so friends anywhere can connect, - patches your local copy of Rec Room to point at the server, - packages a join code your friends paste into their launcher. ## What you'll need - Windows 10 or 11 (Mac and Linux support are not planned) - A copy of **Rec Room 2020.03.10** — the specific old build DorkNet targets. You acquire this yourself; see [Getting the 2020 client](#getting-the-2020-client) below. - A free Photon Cloud account — the launcher walks you through this on first run. - ~5 GB free disk space - About 10 minutes for first-run setup, ~30 seconds per subsequent launch ## Download Two flavours on the [latest release](https://github.com/DorkSquadRR/DorkNet/releases/latest): - **`dorknet-setup-.exe`** *(recommended)* — installer. Drops the launcher under `%LocalAppData%\Programs\DorkNet`, adds Start menu + (optional) desktop shortcut, sets up the auto-updater, registers an uninstaller. No admin rights required. - **`dorknet.exe`** — single-file portable. Drop it anywhere; state lives in `%APPDATA%\DorkNet`. No shortcuts, no auto-updates. Either works the same once it's running. Pick the installer if you'd like Start-menu integration and rolling updates; pick the portable exe if you'd rather no system changes. > Windows SmartScreen may warn you on first launch because the binary > isn't EV-signed. Click "More info" → "Run anyway". ### Auto-updates The installed launcher checks GitHub on every launch for a newer release. If one's available, a small banner appears in the sidebar with an **Install & restart** button. Click it; the launcher downloads the new binary, shuts itself down, swaps the exe in place, and relaunches. Turn this off during setup by un-ticking *Check for updates on launch*, or any time later by editing `HKCU\Software\DorkNet\AutoUpdate` (0 disables). The portable `dorknet.exe` doesn't auto-update — pull a new release yourself when you want one. ## First launch — the welcome screen The very first time you open DorkNet you get a hero screen. ![first-run welcome screen](images/first-run-welcome.png) Click **GET STARTED** to enter the setup wizard. The wizard only runs once; future launches drop you straight into the main view. ## The setup wizard Five steps, top stepper shows your progress. **Back** and **Next** sit in the bottom bar; the choice cards on the first step auto-advance when clicked. ### Step 1 — Pick a mode ![mode pick — Host a server vs Join a friend](images/first-run-welcome-join.png) - **Run a server** — you'll host. The launcher will set up the tunnel and hand you a join code. - **Use a code** — a friend already hosts and gave you a join code. See [joining-a-server.md](joining-a-server.md) for that path. This page is also reachable later via **Re-run setup** in the sidebar, so don't worry about getting it wrong. ### Step 2 — Find your Rec Room install The wizard auto-detects common manual-install locations (it never touches your Steam library). If detection works you'll see a green "Detected install" banner with the path; otherwise click **Browse…** and point at your `Recroom_Release_Data` folder. The path should look like `…\\Recroom_Release_Data` — the *_Data sibling of `Recroom_Release.exe`. The launcher validates this when you continue. ### Step 3 — Set up your server - **Server name** — what shows up in your join code. Use whatever your friends will recognise ("Adam's Sunday games", "DorkSquad Test", etc.). - **Who can join?** — three options, only one shows extra inputs: - **Friends anywhere · Tunnelto** *(default, recommended)* — the launcher runs a Tunnelto tunnel that gives your server a public `*.tunnelto.me` URL. Works for anyone, anywhere. No router config. - **Tunnelto wildcard base** — advanced. If you've got a wildcard Tunnelto subscription, paste the apex domain. Subdomains like `api.`, `auth.`, etc. get auto-generated. - **Same WiFi only · sslip.io** — bind on your LAN only. Friends must be on the same network. No tunnel, lowest latency. ### Step 4 — Connect your Photon account Photon Cloud runs the in-room realtime sync (positions, voice, room state). DorkNet doesn't ship one — you bring your own free account. Click **OPEN WALKTHROUGH** to launch the in-app Photon wizard. It opens your browser to `dashboard.photonengine.com` and walks you through creating two apps (Realtime + Voice). The wizard waits for you to paste the AppIds back in. Voice is optional; without it, voice chat is text-only and you can use Discord on the side. If you've already got AppIds from a previous setup, paste them directly into **REALTIME APPID** and **VOICE APPID** in step 4 and skip the walkthrough. > For a standalone screenshot-by-screenshot guide to the Photon > dashboard, see [photon-setup.md](photon-setup.md). Useful if you > get stuck mid-walkthrough or want to re-do it later. ### Step 5 — Done Confirmation card. Click **Finish** to enter the main view. ## The main view The launcher's everyday UI: ![host view with Server and Photon panels](images/patch-tab.png) - **Sidebar** (left): **Host a server**, **Join a friend**, **Settings**, **Re-run setup**. The brand-coloured stripe marks the active section. The footer at the bottom shows your server's live status (Idle / Starting / Live / Failed) and the launcher version. - **Header** (top of content): a short eyebrow describing the view, the title, and a **Screen mode** checkbox top-right. - **Content**: two panels — **Server** and **Photon Cloud** — followed by the action bar. Everything in the wizard is editable here. If you change anything mid- session, the new values get used the next time you hit Start hosting. ### Server panel - **REC ROOM INSTALL** — same picker as the wizard. The path shows in monospace so you can sanity-check it. - **SERVER NAME · SHOWN TO JOINERS** — text input. Updates the embedded name inside your next join code. - **REC ROOM VERSION TO HOST FOR** — dropdown. Pre-selects the version matching your install. Picking a different version means the launcher will fetch that server build the next time you Start hosting. - **WHO CAN JOIN?** — the same three options as step 3 of the wizard. - **TUNNELTO BASE HOST** — only visible when you pick the wildcard option. Auto-generated otherwise; not needed for the default or LAN modes. ### Photon Cloud panel - **REALTIME APPID** — required. Realtime is the matchmaking + room sync layer. Click the **WALKTHROUGH** button (top-right of the panel) any time you want to re-run the in-app Photon wizard. - **VOICE APPID · OPTIONAL** — if set, voice chat works through Photon Voice. If empty, players use Discord. - **CLOUD REGION** — picks the Photon datacenter. All clients must match. Default is US; change for European / Asian players. ### Screen mode The **Screen mode** checkbox in the header passes `+forcemode:screen` when launching Rec Room, opening the game in 2D desktop mode instead of looking for a VR headset. Useful for testing or for friends who don't have VR. ## Starting your server Hit **START HOSTING** (orange button, bottom of the content panels). The launcher runs through six steps in order: 1. **Download server** — fetches the matching server build into `%LOCALAPPDATA%\DorkNet\servers\\`. ~50 MB the first time; reused on subsequent launches. 2. **Open tunnel** — starts Tunnelto and assigns a public hostname. Skipped in LAN mode. 3. **Start server** — boots the server process. SQLite database lives in `%APPDATA%\DorkNet\dorknet.db`. 4. **Download patcher** — fetches the client-patcher payload that matches your version. 5. **Strip Steam DRM** — only runs if your install is a Steam build (Steamless does the unwrap; original `Recroom_Release.exe` is backed up next to itself). 6. **Apply patch** — rewrites the game's network URLs, Photon AppIds, and embedded keys in place. Progress steps show inline. If any step fails, the row turns red and **Retry** appears under the steps list (along with **Get help** which opens the troubleshooting docs). ## Sharing your server When step 6 finishes, the join code panel appears with the orange "SERVER LIVE" header. You get: - a **QR code** on a white tile — scan with a phone to get the join string into your friend's clipboard, - the join code itself in monospace, - three share actions: - **COPY CODE** — copies just the code, - **Copy as message** — wraps it in a friendly Discord-ready blurb that links back to the DorkNet download, - **Email** — opens your mail client with subject + body filled in. Your friend opens DorkNet, picks **Join a friend** on first launch (or from the sidebar later), pastes the code, and gets the matching patcher. ## Launching the game Once your server is live, the **LAUNCH REC ROOM** button (teal, sits next to **STOP**) becomes visible. Click it; the launcher starts your patched copy with the right command-line args. Toggle **Screen mode** in the header first if you want desktop play. ## Stopping the server **STOP** kills the server process and the tunnel cleanly, hides the join code panel, and re-enables **START HOSTING**. Your data (`dorknet.db`) persists; relaunching restores everything. The launcher also stops the server automatically when you close the window. Don't quit mid-game — your friends will get disconnected. ## Settings Sidebar → **Settings**. - **Cache locations** — read-only paths to your state file, server cache, patcher cache, and logs. Useful for "I want to clear the cache" or "where did my db go". - **Dev overrides** — only appears when one of the `DORKNET_LOCAL_*` env vars is set. Lists which overrides are active. Unset the env vars to return to the normal release-fetching mode. - **About** — version, license (AGPL-3.0), and a link to the GitHub repo. The sidebar also has a **Re-run setup** entry. It clears the "setup-complete" flag without losing your saved values, so the wizard walks again from step 1 — handy if you want to change modes (host ↔ join) or re-do the Photon walkthrough. ## Switching from host to join From the sidebar, click **Join a friend**. Your host settings are preserved (Photon AppIds, server name, etc.) so switching back later picks up where you left off. The SQLite database also stays put. See [joining-a-server.md](joining-a-server.md) for the join-side flow. --- ## Hosting-mode deep-dive | Mode | Tunnel | Public URL | Best for | | --- | --- | --- | --- | | Friends anywhere · Tunnelto | yes | `dorknet-.tunnelto.me` | Default — works for everyone, no setup | | Tunnelto wildcard base | yes | `` + `api.`, `auth.`, … | Power users with a wildcard Tunnelto plan | | Same WiFi only · sslip.io | no | `.sslip.io` | LAN games, lowest latency, no internet exposure | Default mode is the right pick for >95% of cases. The wildcard mode is only useful if you've already got a stable apex domain set up. LAN mode is for when everyone's in the same room. --- ## Getting the 2020 client DorkNet doesn't ship the Rec Room game itself — that's Rec Room Inc.'s intellectual property. You acquire your own copy through legal means. Common paths: - If you bought Rec Room on Steam before 2020, you can use SteamDB depot tools to download the old build (manifest `4651244957411961725` for `Recroom_Release_Data`). - Friends who already have a 2020 install can share files with you under whatever license terms apply on their end. DorkNet's authors can't help you obtain the game. Search the web for "Steam depot 2020.03.10 Rec Room" if you need pointers. --- ## Troubleshooting See [troubleshooting.md](troubleshooting.md) for the full list. The most common problems: - **Server starts but friend can't connect** — Cloudflare Quick Tunnels rotate the URL on every restart. Re-share the join code if you've restarted hosting. - **"Photon CustomAuth 401" in the server log** — your Realtime AppId on the server doesn't match what the launcher patched into the client. Make sure both sides use the same AppIds. - **Game launches but stays on the loading screen** — your friend didn't run the patcher. Their Join view needs to complete step 3 (Apply Patch) before launching Rec Room. - **Game launches but goes straight back to the title screen** — your Photon region setting differs from your friend's. Both clients must match. Set in Photon Cloud → CLOUD REGION. Logs live at `%LOCALAPPDATA%\DorkNet\logs\` and capture the full server output for each session.