Repository navigation
v2.5.4 - macOS Port Conflict Fix
v2.5.4 - macOS Port Conflict Fix
π Bug Fixes
Telnet Server Port Conflict on macOS
- Changed default telnet port from 5000 to 5001
- Resolves conflict with macOS AirPlay Receiver (Monterey+)
- Updated all configuration files and documentation
π Changes
- mud/main.py: Updated
socketserverdefault port to 5001 - mud/config.py: Changed
PORTenvironment default from 5000 to 5001 - Dockerfile: Updated
EXPOSEdirective to port 5001 - docker-compose.yml: Updated port mapping to 5001
- README.md: Updated all port references and added macOS warning note
π Documentation
- Added macOS AirPlay Receiver warning in README Quick Start section
- Explains port 5000 conflict with macOS Monterey+ AirPlay service
- Provides example of custom port usage:
--port 4000
β οΈ Breaking Changes
None - Backward compatible. Users can still specify custom ports via --port flag.
π Impact
This fix resolves the "address already in use" error that macOS users encounter when starting the telnet server, caused by macOS ControlCenter process binding to port 5000 for AirPlay Receiver.
Full Changelog: v2.5.3...v2.5.4