Astroneer Dedicated Server Troubleshooting

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

• 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 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

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

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

Always: stop → edit → save → start.

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

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

• Server Configuration
• Server Ownership
• How to Join Your Server