# Avorion Server Troubleshooting (/docs/avorion/troubleshooting)



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

Server Not Listed Publicly [#server-not-listed-publicly]

Set `isListed = true` and `useSteam = true` in `server.ini` under `[Networking]`. Restart the server.

Cannot Connect [#cannot-connect]

* Verify firewall rules for **all ports**: 27000 (TCP+UDP), 27003 (UDP), 27020 (UDP), 27021 (UDP)
* Direct IP only works on port **27000** — custom ports require Steam networking
* Check that `useSteam = true` for the best connectivity

Save Corruption [#save-corruption]

**Cause:** Force-closing the server console without using `/save` and `/stop`.

**Prevention:** Always shut down gracefully:

```
/save
/stop
```

**Recovery:** If backups are enabled (`backups = true`), find hourly backups in the galaxy folder or `backupsPath`.

Memory Issues [#memory-issues]

* Schedule daily restarts to clear accumulated memory
* Reduce `workerThreads` to match your CPU core count
* Reduce `aliveSectorsPerPlayer` from 5 to 3

Mod Problems [#mod-problems]

* Ensure `modconfig.lua` has correct Workshop IDs
* Workshop mods auto-update on restart — restart to pull fixes
* If `forceEnabling = true`, all clients must have matching mods

Config Keeps Resetting [#config-keeps-resetting]

The server overwrites `server.ini` on startup. **Always stop the server before editing.** Changes made while running are lost.

Hosting and Playing on Same Machine [#hosting-and-playing-on-same-machine]

Connect via `127.0.0.1:27000` (local IP), not your external IP. This avoids hairpinning issues.

Related Guides [#related-guides]

* [Server Configuration](/docs/avorion/server-config)
* [Admin Setup](/docs/avorion/admin-setup)
* [How to Join Your Server](/docs/avorion/join-server)