/[LeafOK_CVS]/lbbs/README.md
ViewVC logotype

Annotation of /lbbs/README.md

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.12 - (hide annotations)
Tue Jun 24 13:30:52 2025 UTC (8 months, 3 weeks ago) by sysadm
Branch: MAIN
Changes since 1.11: +3 -4 lines
Content type: text/markdown
Update version and Changelog

1 sysadm 1.7 # LBBS - Classical terminal server of LeafOK BBS
2 sysadm 1.1
3 sysadm 1.11 Copyright (C) 2004-2025 by Leaflet
4     Email : leaflet@leafok.com
5     Demo site : bbs.fenglin.info (Telnet 2323 / SSH2 2322)
6 sysadm 1.1
7    
8     Introduction
9     =================
10 sysadm 1.11 This software (named as LBBS) aims to providing a telnet-based interface for a pure web-based BBS (named as LeafOK BBS).
11     LeafOK BBS (https://github.com/leafok88/leafok_bbs) provides almost all fundamental BBS features as well as many additional plugins. Its major part was written in PHP + MySQL.
12 sysadm 1.1 Thank you for using this software. If you meet any bugs or have any suggestion, please tell me.
13    
14    
15     System Requirement
16     ==================
17     1) GNU C Compiler
18     2) PHP ( Version >= 8.2 )
19     3) MySQL database ( Version >= 8.4 )
20    
21    
22     Quick Installation
23     ==================
24     To install LBBS quickly, please do the following steps:
25    
26 sysadm 1.9 0) Prerequisite
27    
28     Follow README.md under https://github.com/leafok88/leafok_bbs to initialize the database structure shared by both web version and telnet version. It is highly recommended to finish the configuration steps of web version first and make sure those features could work properly.
29    
30 sysadm 1.11 1) Extract the source files from a tarball or export from GitHub
31     Run the following command to set up the autoconf/automake environment,
32     sh ./autogen.sh
33 sysadm 1.1 and fix any error if exists.
34    
35 sysadm 1.11 2) Compile source files
36     ./configure --prefix=/usr/local/lbbs
37 sysadm 1.1 make
38    
39 sysadm 1.11 3) Create user and group
40 sysadm 1.2 sudo useradd bbs
41 sysadm 1.1
42 sysadm 1.11 4) Install binary files and data files
43 sysadm 1.2 sudo make install
44 sysadm 1.1
45 sysadm 1.11 5) Modify following configuration files
46     Default configuration files is saved as *.default, you should rename them first.
47     /usr/local/lbbs/conf/bbsd.conf
48 sysadm 1.1 /usr/local/lbbs/utils/conf/db_conn.inc.php
49    
50 sysadm 1.11 6) Generate menu configuration file with section data by running the script
51 sysadm 1.6 sudo -u bbs php /usr/local/lbbs/utils/bin/gen_section_menu.php
52 sysadm 1.12 sudo -u bbs php /usr/local/lbbs/utils/bin/gen_ex_list.php
53 sysadm 1.6
54 sysadm 1.11 7) Create or copy SSH2 RSA certificate into /usr/local/lbbs/conf
55 sysadm 1.8 ssh-keygen -t rsa -C "Your Server Name" -f ssh_host_rsa_key
56    
57 sysadm 1.11 8) Startup
58 sysadm 1.3 sudo /usr/local/lbbs/bin/bbsd
59 sysadm 1.1
60 sysadm 1.11 9) Set up systemd
61 sysadm 1.12 Create your own /usr/lib/systemd/system/lbbs.service from the sample at conf/lbbs.service.default, and make any change if necessary.
62     Reload daemon config and start the service.

webmaster@leafok.com
ViewVC Help
Powered by ViewVC 1.3.0-beta1