Files
Commonwealth-Online-Server/server/PORT_TROUBLESHOOTING.txt
T

62 lines
1.6 KiB
Plaintext

================================================================================
COMMONWEALTH ONLINE - PORT TROUBLESHOOTING
================================================================================
ERROR: "Only one usage of each socket address ... is normally permitted"
TCP port 7777 is already in use by another process.
QUICK FIX
=========
Windows:
fix-port.bat
Linux / macOS:
./fix-port.sh
Choose:
1. Kill the process using TCP 7777 and restart
2. Start on a different port
3. Cancel
MANUAL PORT OVERRIDE
====================
Published Windows server:
CommonwealthOnline.Server.exe serve --config commonwealth-server.json --port 8000
Published Linux server:
./CommonwealthOnline.Server serve --config commonwealth-server.json --port 8000
Source checkout:
dotnet run --project CommonwealthOnline.Server.csproj -- serve --config commonwealth-server.json --port 8000
You can also change "port" in commonwealth-server.json and restart.
FIND THE BLOCKING PROCESS
=========================
Windows, Administrator Command Prompt:
netstat -aon | find ":7777"
taskkill /PID <PID> /F
Linux / macOS:
lsof -i :7777
kill -9 <PID>
GNS NOTE
========
When GameNetworkingSockets is enabled, the server uses the same numeric game
port over UDP. TCP and UDP are separate transports, but firewalls and router
rules must allow the protocol you intend to use.
REMOTE HOSTING
==============
If you change the game port, update firewall/router rules and tell players the
new host:port. Do not expose the localhost admin port (default TCP 7779).
================================================================================