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

Diff of /lbbs/README.md

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.11 by sysadm, Sun Jun 22 12:34:56 2025 UTC Revision 1.16 by sysadm, Wed Jul 9 14:03:27 2025 UTC
# Line 7  Demo site : bbs.fenglin.info (Telnet 232 Line 7  Demo site : bbs.fenglin.info (Telnet 232
7    
8  Introduction  Introduction
9  =================  =================
10  This software (named as LBBS) aims to providing a telnet-based interface for a pure web-based BBS (named as LeafOK BBS).    This software aims to providing a telnet-based interface for a pure web-based BBS [leafok_bbs](https://github.com/leafok88/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.    ![Welcome](misc/images/ssh_welcome.jpg "Welcome to LBBS")  
12  Thank you for using this software. If you meet any bugs or have any suggestion, please tell me.  ![Menu](misc/images/telnet_menu.jpg "Main menu")  
13    ![Section](misc/images/telnet_section.jpg "List of articles")  
14    ![Reader](misc/images/telnet_article_reader.jpg "Article reader")  
15    
16    
17  System Requirement  System Requirement
18  ==================  ==================
19  1) GNU C Compiler  1) GNU C Compiler  
20  2) PHP ( Version >= 8.2 )  2) PHP ( Version >= 8.2 )  
21  3) MySQL database ( Version >= 8.4 )  3) MySQL database ( Version >= 8.4 )  
22    
23    
24  Quick Installation  Quick Installation
25  ==================  ==================
26  To install LBBS quickly, please do the following steps:  To install LBBS quickly, please do the following steps:
27    
28  0) Prerequisite  0) Prerequisite  
29       Follow README.md under [leafok_bbs](https://github.com/leafok88/leafok_bbs) to initialize the database structure shared by both web version and telnet version.  
30     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.     It is highly recommended to finish the configuration steps of web version first and make sure those features could work properly.
31    
32  1) Extract the source files from a tarball or export from GitHub    1) Extract the source files from a tarball or export from GitHub  
33     Run the following command to set up the autoconf/automake environment,       Run the following command to set up the autoconf/automake environment,  
# Line 45  To install LBBS quickly, please do the f Line 47  To install LBBS quickly, please do the f
47  5) Modify following configuration files    5) Modify following configuration files  
48     Default configuration files is saved as *.default, you should rename them first.       Default configuration files is saved as *.default, you should rename them first.  
49     /usr/local/lbbs/conf/bbsd.conf       /usr/local/lbbs/conf/bbsd.conf  
50     /usr/local/lbbs/utils/conf/db_conn.inc.php     /usr/local/lbbs/utils/conf/db_conn.inc.php  
51    
52  6) Generate menu configuration file with section data by running the script    6) Generate menu configuration file with section data by running the script  
53     sudo -u bbs php /usr/local/lbbs/utils/bin/gen_section_menu.php     sudo -u bbs php /usr/local/lbbs/utils/bin/gen_section_menu.php  
54       sudo -u bbs php /usr/local/lbbs/utils/bin/gen_ex_list.php  
55    
56  7) Create or copy SSH2 RSA certificate into /usr/local/lbbs/conf    7) Create or copy SSH2 RSA certificate into /usr/local/lbbs/conf  
57     ssh-keygen -t rsa -C "Your Server Name" -f ssh_host_rsa_key     ssh-keygen -t rsa -C "Your Server Name" -f ssh_host_rsa_key
# Line 57  To install LBBS quickly, please do the f Line 60  To install LBBS quickly, please do the f
60     sudo /usr/local/lbbs/bin/bbsd     sudo /usr/local/lbbs/bin/bbsd
61    
62  9) Set up systemd    9) Set up systemd  
63     Create your own /usr/lib/systemd/system/lbbs.service from the sample at conf/lbbs.service.default, and make any change if necessary. Please note that the startup argument "-f" with bbsd should be used in systemd notify mode.       Create your own /usr/lib/systemd/system/lbbs.service from the sample at conf/lbbs.service.default, and make any change if necessary.  
64     Run the following bash command to startup the service:       Reload daemon config and start the service.  
    sudo systemctl daemon-reload    
    sudo systemctl start lbbs  

Legend:
Removed lines/characters  
Changed lines/characters
  Added lines/characters
webmaster@leafok.com
 ViewVC Help
Powered by ViewVC 1.3.0-beta1