COLOR 64 BBS v8.1a - TROUBLESHOOTING
Mac OS LTK Build

------------------------------------------------------------

This file lists common problems and solutions when running
Color 64 BBS on Mac OS.

------------------------------------------------------------
PROBLEM: x64sc NOT FOUND
------------------------------------------------------------

Cause:
  VICE has not been built, or x64sc is not in PATH.

Fix:
  - Run ./vicebuild.sh
  - Verify x64sc runs from the command line
  - Anticipated path: $HOME/vice-acia/bin/x64sc

------------------------------------------------------------
PROBLEM: BBS WILL NOT ACCEPT CONNECTIONS
------------------------------------------------------------

Cause:
  - ACIA Fix not applied
  - tcpser not running
  - Incorrect port or speed

Fix:
  - Ensure vicebuild.sh completed successfully
  - launch system using "mybbs-macos.sh" (launches Vice in
    Proper configuration and TCPSER)
  - Alternative: Start tcpser before starting the BBS, using
    "mybbs-tcpser.sh" then launch BBS with "mybbs-vice.sh"
  - Verify tcpser port matches BBS configuration

------------------------------------------------------------
PROBLEM: DTR in TCPSER will not go "high"
------------------------------------------------------------

Cause:
  - TCPSER internal port (defined by flag -v in
    mybbs-tcpser.sh) does not match RS232 port defined in
    config.ini
  - Vice was launched before TCPSER

Fix:
  - In config.ini, ensure the following line is present:
    RsDevice3="127.0.0.1:25237"
  - Ensure "-v" flag in mybbs-tcpser.sh port is defined as
    "25237" (without quotes)
  - Ensure TCPSER is active prior to Vice initializing

------------------------------------------------------------
PROBLEM: EMAIL NOTIFICATIONS NOT WORKING
------------------------------------------------------------

Cause:
  - notify.py not configured
  - Python not installed
  - Username/password mismatch

Fix:
  - Verify python3 is installed
  - Check SMTP settings in notify.py
  - Verify √BBS.INIT credentials match notify.py

------------------------------------------------------------
WHERE TO GET HELP
------------------------------------------------------------

Documentation:
https://color64wiki.itchybutt.org

Support forum:
https://www.itchybutt.org

------------------------------------------------------------
END OF TROUBLESHOOTING
------------------------------------------------------------
