# StarRupture Server Troubleshooting (/docs/starrupture/troubleshooting)



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

Server Won't Start [#server-wont-start]

<div className="fd-steps">
  <div className="fd-step">
    Check the Console [#1-check-the-console]

    Go to the `Dashboard` in the XGamingServer Panel and look at the console output for error messages.
  </div>

  <div className="fd-step">
    Verify Startup Settings [#2-verify-startup-settings]

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

  <div className="fd-step">
    Delete the steamapps Folder [#3-delete-the-steamapps-folder]

    Go to `Files`, delete the `steamapps` folder, and restart. This forces a fresh server file download.
  </div>

  <div className="fd-step">
    Reinstall as Last Resort [#4-reinstall-as-last-resort]

    If nothing else works, follow our [Reset Server](/docs/starrupture/wipe-reinstall) guide to do a full reinstall.
  </div>
</div>

Players Can't Connect [#players-cant-connect]

<div className="fd-steps">
  <div className="fd-step">
    Confirm the Server Is Running [#1-confirm-the-server-is-running]

    Check the `Dashboard` to verify the server status shows **Running**.
  </div>

  <div className="fd-step">
    Check the IP Address [#2-check-the-ip-address]

    Make sure players are using the correct IP and port from the panel sidebar.
  </div>

  <div className="fd-step">
    Verify the Password [#3-verify-the-password]

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

  <div className="fd-step">
    Restart the Server [#4-restart-the-server]

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

    > 📝 **Note:** For more detailed connection troubleshooting, see our [Ports and Firewall](/docs/starrupture/server-ports-firewall) guide.
  </div>
</div>

Server Crashing [#server-crashing]

<div className="fd-steps">
  <div className="fd-step">
    Check for Updates [#1-check-for-updates]

    Make sure your server is running the latest version. See our [Update Guide](/docs/starrupture/update-guide).
  </div>

  <div className="fd-step">
    Review Console Logs [#2-review-console-logs]

    Check the console output on the `Dashboard` for crash-related error messages.
  </div>

  <div className="fd-step">
    Reduce Auto-Save Frequency [#3-reduce-auto-save-frequency]

    Very frequent auto-saves on large worlds can cause issues. Try increasing the `SaveGameInterval` in your [DSSettings.txt](/docs/starrupture/dssettings-configuration).
  </div>

  <div className="fd-step">
    Monitor Player Count [#4-monitor-player-count]

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

Save File Issues [#save-file-issues]

<div className="fd-steps">
  <div className="fd-step">
    Check Save File Names [#1-check-save-file-names]

    Save files must be named `AutoSave0.sav` and `AutoSave0.met`. Incorrect naming will prevent loading.
  </div>

  <div className="fd-step">
    Verify Session Name Matches [#2-verify-session-name-matches]

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

  <div className="fd-step">
    Restore from Backup [#3-restore-from-backup]

    If your save is corrupted, go to `Backups` in the sidebar and restore a previous backup.
  </div>
</div>

Performance Issues [#performance-issues]

<div className="fd-steps">
  <div className="fd-step">
    Restart Regularly [#1-restart-regularly]

    Schedule regular restarts using the `Schedules` feature in the sidebar. This helps clear memory leaks.
  </div>

  <div className="fd-step">
    Reduce Player Count [#2-reduce-player-count]

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

  <div className="fd-step">
    Increase Auto-Save Interval [#3-increase-auto-save-interval]

    Auto-saves cause brief lag spikes. Increase the interval in [DSSettings.txt](/docs/starrupture/dssettings-configuration) 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](https://discord.xgamingserver.com) for help.
  </div>
</div>