# Subnautica 2 Server Troubleshooting (/docs/subnautica-2/troubleshooting) import { Callout } from "fumadocs-ui/components/callout"; If you're hitting issues with your Beacon-powered Subnautica 2 server, walk through the checklist below. Beacon is a brand-new framework (first release May 2026). Bugs are expected to surface as more people use it. If you hit something not covered here, open a ticket with us and we'll escalate. Players can't connect [#players-cant-connect] Wrong IP or port [#wrong-ip-or-port] The most common cause. Confirm with the server owner that the friend is using `IP:GameplayPort` — the GameplayPort, not the QueryPort (+2), RconPort (+3), or HttpPort (+4). Default GameplayPort is `27015`, but panels may assign a different one — check the panel Dashboard for the exact value. Server not running [#server-not-running] Check the panel Dashboard — is the server status green? Look at the console output for errors. Common reasons a Beacon server won't start: * `RconPassword` is empty (some Beacon builds require it set) * Retail Subnautica 2 install path (`SnInstallRoot`) doesn't exist or is wrong * UE4SS injection failed at startup If the console shows an error, screenshot it and open a support ticket — we'll fix the install. Client firewall blocking outbound [#client-firewall-blocking-outbound] Some Windows firewall configs block outbound UDP. Have the friend temporarily disable Windows Firewall (or whitelist `BeaconLauncher.exe`) and try again. Server password mismatch [#server-password-mismatch] If you've set `ServerPassword` in `appsettings.json`, friends need to enter the matching password in the Beacon Launcher. Empty password = no password required. Beacon Launcher injects but client stays in single-player [#beacon-launcher-injects-but-client-stays-in-single-player] UE4SS injection failed silently. Have the friend: 1. Run `BeaconLauncher.exe` as Administrator 2. Confirm their Subnautica 2 install isn't in a permission-restricted directory (Program Files can sometimes block injection) 3. Reinstall the Beacon Launcher to the latest version "Version mismatch" between client and server [#version-mismatch-between-client-and-server] The Beacon Launcher version on the friend's PC and BeaconServer on your hosted server need to match (or be compatible). Beacon does not guarantee cross-version compatibility while in early releases. We keep your server updated to the latest stable Beacon release. Friends should download the latest Beacon Launcher from [github.com/HumanGenome/Beacon/releases](https://github.com/HumanGenome/Beacon/releases). Subnautica 2 itself updated and broke things [#subnautica-2-itself-updated-and-broke-things] When UWE pushes a Subnautica 2 update, Beacon often needs an update too. We monitor this and roll out Beacon updates on our infrastructure. You may experience brief downtime during these updates. If you suspect your server is broken because of an S2 update: 1. Check the [Beacon GitHub Releases](https://github.com/HumanGenome/Beacon/releases) — is there a newer Beacon version that mentions the new S2 update? 2. Open a support ticket — we'll trigger the update on your server Save snapshots aren't being written [#save-snapshots-arent-being-written] Check `SnapshotsEnabled` in `appsettings.json` — should be `true` by default. If it's `false`, set it to `true` and restart the server. Snapshots are stored under `SaveDir` (default `C:\Beacon\saves`). The panel File Manager lets you browse them. RCON / HTTP API not responding [#rcon--http-api-not-responding] Both auth against `RconPassword`. If it's empty, those endpoints may be disabled or refuse connections. Set a strong password in `appsettings.json` and restart. For Source RCON, the port is `GameplayPort + 3` (default 27018, TCP). For HTTP API, it's `GameplayPort + 4` (default 27019, TCP). Make sure your client is hitting the right port. Getting more help [#getting-more-help] * **Open a ticket** with us at [billing.xgamingserver.com/contact.php](https://billing.xgamingserver.com/contact.php) — we'll dig into Windows host logs * **Beacon issues:** [github.com/HumanGenome/Beacon/issues](https://github.com/HumanGenome/Beacon/issues) — for framework bugs (rare, but possible) * **Subnautica 2 game bugs:** Unknown Worlds' official channels — not us, not Beacon Related [#related] * [Dedicated Server Setup →](/docs/subnautica-2/dedicated-server-setup) * [Join via Beacon Launcher →](/docs/subnautica-2/join-server) * [appsettings.json Reference →](/docs/subnautica-2/configure-your-server)