StarRupture Server Troubleshooting

Common StarRupture server issues and how to fix them. Resolve crashes, connection problems, save corruption, and performance issues.

This guide covers the most common StarRupture server issues and their solutions.

Server Won't Start

Go to the Dashboard in the XGamingServer Panel and look at the console output for error messages.

In the sidebar, go to Startup and make sure all settings are valid. An invalid session name or conflicting settings can prevent startup.

Go to Files, delete the steamapps folder, and restart. This forces a fresh server file download.

If nothing else works, follow our Reset Server guide to do a full reinstall.

Check the Dashboard to verify the server status shows Running.

Make sure players are using the correct IP and port from the panel sidebar.

If your server has a password, make sure players are entering it correctly. Check it under Startup → Basic → Server Password.

A restart often resolves connection issues, especially after an update.

📝 Note: For more detailed connection troubleshooting, see our Ports and Firewall guide.

Make sure your server is running the latest version. See our Update Guide.

Check the console output on the Dashboard for crash-related error messages.

Very frequent auto-saves on large worlds can cause issues. Try increasing the SaveGameInterval in your DSSettings.txt.

StarRupture officially supports up to 4 players in co-op. Running with more players can cause instability and desync.

Save files must be named AutoSave0.sav and AutoSave0.met. Incorrect naming will prevent loading.

The Session Name in Startup must match the save folder name under StarRupture/Saved/SaveGames/.

If your save is corrupted, go to Backups in the sidebar and restore a previous backup.

Schedule regular restarts using the Schedules feature in the sidebar. This helps clear memory leaks.

Late-game factories with many machines can cause lag, especially with 4 players. Reducing to 2-3 players can help.

Auto-saves cause brief lag spikes. Increase the interval in DSSettings.txt if they're too frequent.

💡 Tip: StarRupture is in Early Access, so performance improvements are expected with future updates. If you're stuck, join our Discord for help.