andrew
881aa33eef
Adds end-to-end Linux compatibility work for the dedicated server: new CI workflow (Ubuntu + Arch), line-ending/executable safeguards, and a local venv-first startup flow with split dependency files for server vs optional host GUI tooling. Improves runtime resilience with better bind error messages, stricter config validation, writable-state checks, cleaner socket/thread shutdown behavior, and SIGTERM-aware graceful stop handling for headless/systemd use. Updates deployment/startup docs and adds portability/runtime integration tests to lock in these behaviors.
71 lines
2.1 KiB
Plaintext
71 lines
2.1 KiB
Plaintext
================================================================================
|
|
COMMONWEALTH ONLINE - PORT TROUBLESHOOTING
|
|
================================================================================
|
|
|
|
ERROR: "Only one usage of each socket address ... is normally permitted"
|
|
|
|
This means port 7777 is already in use by another process.
|
|
|
|
QUICK FIXES:
|
|
============
|
|
|
|
Option 1: Use fix-port.bat / fix-port.sh (Recommended)
|
|
------------------------------------------------------
|
|
Windows: double-click fix-port.bat
|
|
Linux / macOS: ./fix-port.sh
|
|
|
|
Then choose an option:
|
|
- Press 1 to kill the blocking process and restart
|
|
- Press 2 to use a different port
|
|
- Press 3 to cancel
|
|
|
|
Option 2: Manually change the port
|
|
-----------------------------------
|
|
1. Open commonwealth-server.json in a text editor
|
|
2. Find the line: "port": 7777
|
|
3. Change to a different port, e.g. "port": 8000
|
|
4. Save the file
|
|
5. Run start.bat (Windows) or ./start.sh (Linux / macOS) again
|
|
|
|
Option 3: Use the CLI with port override
|
|
-----------------------------------------
|
|
Open a terminal in the server folder and run:
|
|
|
|
# Windows
|
|
.venv\Scripts\python.exe -u consumer_server_cli.py serve --config commonwealth-server.json --port 8000
|
|
|
|
# Linux / macOS
|
|
.venv/bin/python -u consumer_server_cli.py serve --config commonwealth-server.json --port 8000
|
|
|
|
If .venv does not exist yet, run start.bat / ./start.sh once first.
|
|
|
|
Option 4: Find and kill the blocking process manually
|
|
------------------------------------------------------
|
|
Windows (Command Prompt as Administrator):
|
|
netstat -aon | find ":7777"
|
|
taskkill /PID <PID> /F
|
|
|
|
Linux / macOS:
|
|
lsof -i :7777
|
|
kill -9 <PID>
|
|
|
|
CHECKING DIFFERENT PORTS:
|
|
=========================
|
|
|
|
Common available ports:
|
|
- 8000
|
|
- 8080
|
|
- 9000
|
|
- 9999
|
|
|
|
Choose any port between 1024 and 65535 that isn't in use.
|
|
|
|
FORWARDING FOR REMOTE CONNECTIONS:
|
|
===================================
|
|
|
|
If using a non-standard port (not 7777), remember to:
|
|
1. Forward that port on your router
|
|
2. Tell remote players to connect to your_ip:port_number
|
|
|
|
================================================================================
|