================================================================================
  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).

================================================================================
