Avorion Connection Failed
Most Avorion joins fail in one of four layers: version, mods, network or galaxy readiness. Check them in that order instead of regenerating the galaxy.
Join triage
- Confirm the client and server are on the same branch and build.
- Compare the client’s mod collection with
modconfig.lua. - Try direct connection with the panel’s game port.
- Check the configured game, query and required service ports.
- Wait for a large galaxy to finish loading after restart.
Symptom map
| Symptom | First suspect |
|---|---|
| Rejected immediately | Build or mod mismatch. |
| Times out | Game port, firewall or wrong address. |
| Browser empty, direct join works | Query path or filters. |
| Join fails only after restart | Galaxy still loading or a startup mod error. |
Do not delete a galaxy to fix a connection error. A connection failure is usually outside the save; protect the save while you isolate the layer.
See the browser guide and managed Avorion hosting.