# Astroneer Dedicated Server Troubleshooting (/docs/astroneer/troubleshooting)



import { Step, Steps } from 'fumadocs-ui/components/steps';

Server Not Appearing in Browser [#server-not-appearing-in-browser]

* `PublicIP` must be set to your **actual public IP** in `AstroServerSettings.ini`
* Port **8777 UDP** must be forwarded in your firewall
* Wait 2–3 minutes after startup for the server to register
* Use **Direct Connect** (`IP:8777`) as a workaround

"Unable to Connect" Error [#unable-to-connect-error]

* The game port must be **UDP**, not TCP — verify your port forwarding
* Verify you're connecting to the correct IP and port (8777)
* Check that the server is actually running in the panel console

Save Corruption [#save-corruption]

Save corruption is almost always caused by **forced shutdowns during auto-save**.

**Prevention:**

* Always stop the server gracefully via the panel
* Increase `AutoSaveGameInterval` if saves cause lag (e.g., `1800` = 30 minutes)
* Keep `BackupSaveGamesInterval` enabled for automatic backups

**Recovery:**

* Navigate to `Astro/Saved/SaveGames/`
* Backup saves have timestamps — rename the newest backup to your `ActiveSaveFileDescriptiveName`
* Restart the server

High RAM / Poor Performance [#high-ram--poor-performance]

Astroneer servers use **2–6 GB+ RAM** as worlds grow. This is a known engine behavior.

**Mitigations:**

* Schedule periodic server restarts (every 12–24 hours) to clear memory
* Encourage players to clean up unused tethers and items — these are the biggest performance drain
* Monitor RAM usage via the panel

Config Changes Not Applying [#config-changes-not-applying]

> ⚠️ **Never edit config files while the server is running.** Changes are overwritten on shutdown.

Always: stop → edit → save → start.

Ownership Not Working [#ownership-not-working]

* `OwnerName` must **exactly match** your current Steam display name (case-sensitive)
* If using `OwnerGuid=0`, you must be the first player to connect after setting it
* After connecting, check `AstroServerSettings.ini` — your GUID should now be filled in

ConsolePort Security [#consoleport-security]

The `ConsolePort` (default 1234, TCP) should **never be exposed to the public internet**. It's for local administration only. If exposed, anyone can send commands to your server.

Related Guides [#related-guides]

* [Server Configuration](/docs/astroneer/server-settings)
* [Server Ownership](/docs/astroneer/server-owner)
* [How to Join Your Server](/docs/astroneer/join-server)