COLOR 64 BBS v8.1a - TROUBLESHOOTING
Linux LTK Build

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

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

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

Message:
  "Not found - have you performed vicebuild.sh yet?"

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

Fix:
  - Run ./vicebuild.sh
  - Log out and log back in
  - Verify x64sc runs from the command line

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

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

Fix:
  - Ensure vicebuild.sh completed successfully
  - Start tcpser before starting the BBS
  - Verify tcpser port matches BBS configuration

------------------------------------------------------------
PROBLEM: SCRIPT FAILS WITH PACKAGE ERRORS
------------------------------------------------------------

Cause:
  - Missing repositories
  - Unsupported Linux distribution

Fix:
  - Ensure you have sudo access
  - On RHEL-like systems, enable CRB/PowerTools/EPEL repos
  - Re-run the script and read the error message carefully

------------------------------------------------------------
PROBLEM: TERMINAL DOES NOT OPEN
------------------------------------------------------------

Cause:
  - No supported terminal emulator installed

Fix:
  - Install one of the following:
    xfce4-terminal, konsole, gnome-terminal, xterm

------------------------------------------------------------
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
------------------------------------------------------------
