31 October 2025 Build
Color 64 BBS Version 8.1a - Mike Newkirk
Support: www.itchybutt.org
         bbs: itchybutt.org:6502
         email: nuke@itchybutt.org
Significant contributions from Darkstar at Arrakis BBS: atl.ddns.net:6403
Vice Installer courtesy of Al Derosa

Greetings!
This is a preset build of Color 64 BBS version 8.1a, a modified and updated version of 8.1, in a near-ready-to-run state for Linux. This build requires a modified version of Vice to properly connect with TCPSER with the ACIA Fix implemented. Please run "vicebuild.sh" prior to BBS Setup. The script is written for Debian systems, but other distro users can mimic the steps in the script with their specific commands. I have successfully run this script as-is with Ubuntu, and did step-by-step modifications for Fedora, both of which were successful.

For ease of installation, please keep on hand either your sysop's manual (8.1a version preferred) or follow along with the online manual at https://color64wiki.itchybutt.org.
You can also find LTK-specific notes at https://www.color64wiki.itchybutt.org/index.php/LTKNotes

Technical support available at Color 64 Support Forum at Discourse https://www.itchybutt.org

Please verify prior to execution:
- script files (.sh files) are using proper location for your installation

Notes regarding this install:
- The LTK structure is designed as follows:
  LU 0 User 0: Holds all Program, System, Help, Text files, Caller Log, Network files
  LU 1 User 0: Public and Private messages
  LU 1 User 1: Category 1 for downloads
  LU 1 User 2: Category 2 for downloads
  LU 1 User 3: Category 3 for downloads
  LU 1 User 4: Category 4 for downloads
  LU 1 User 5: Category 5 for downloads
  LU 1 User 15: Uploads
  LU 2 User 0: Aux 1 Files (includes user signature information)
  LU 2 User 1: Aux 2 Files (currently not utilized in this build)
  LU 2 User 3: Aux 3 Files (holds the game area for this build)
- LTK specific modifications from the Color 64 8.0 disks have been incorporated as recommended by the original developers.
- BOOTMAKER has already been completed for system setup
- Modifications of Main Parameters (in +SETUP program) are not required, but Sysop may want to review selections made prior to deploying system.
- MODEM INIT string in +SETUP has already been properly defined for this configuration.
- Two Games are prebuilt with the system. Additional games are included in the D64 files (disks 4 and 5), also included with this distribution
   - be sure to update the file "√games menu" on LU 2/User 3 with the games operational with your system.

Installation:
- Install in user home directory
- If you desire email notifications of BBS activity:
   - install python3 if not installed
   - modify "notify.py" for SMTP server information and selected username and password for BBS login to the script
   - modify √BBS.INIT program at lines 35705-35706 to match username/password selected (currently they match as "username" and "password") and verify IP setting of your PC in this section as well!
   - modify "mybbs.sh": remove remark for python3 execution
   - When BBS is in operation, at the call screen, press "up arrow" (the "\" key on PC keyboard - to enable/disable feature)

- Running the LTK
   - Open a terminal in the directory color64_v81a_ltk build on your computer
   - run "./mybbs.sh"
   - From there you can run the BBS, Setup, or Editor (to edit screens)
        - L +BBS to load and run BBS
        - L +SETUP to enter BBS setup
        - L +EDITOR to load editor and modify system screens

Refer to Sysop Manual for additional information on these specific (and other) files, as well as the screens used for BBS operation.

