/[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.14 by sysadm, Fri Jun 27 00:57:08 2025 UTC Revision 1.24 by sysadm, Sat Jan 3 10:27:14 2026 UTC
# Line 1  Line 1 
1  # LBBS - Classical terminal server of LeafOK BBS  # LBBS - Classical terminal server of LeafOK BBS
2    
3  Copyright (C) 2004-2025 by Leaflet    中文版本的README.md位于[README.zh_CN.md](README.zh_CN.md)
 Email : leaflet@leafok.com    
 Demo site : bbs.fenglin.info (Telnet 2323 / SSH2 2322)  
4    
5    
6  Introduction  Introduction
7  =================  =================
8  This software (named as LBBS) aims to providing a telnet-based interface for a pure web-based BBS (LeafOK BBS @ https://github.com/leafok88/leafok_bbs).  This software aims to providing a telnet-based interface for a pure web-based BBS [leafok_bbs](https://github.com/leafok/leafok_bbs).  
9    Demo site : fenglin.info (Telnet 2323 / SSH2 2322)  
10    ![Welcome](misc/images/ssh_welcome.jpg "Welcome to LBBS")  
11    ![Menu](misc/images/telnet_menu.jpg "Main menu")  
12    ![Section](misc/images/telnet_section.jpg "List of articles")  
13    ![Reader](misc/images/telnet_article_reader.jpg "Article reader")  
14    
15    
16  System Requirement  System Requirement
# Line 17  System Requirement Line 20  System Requirement
20  3) MySQL database ( Version >= 8.4 )    3) MySQL database ( Version >= 8.4 )  
21    
22    
23  Quick Installation  Installation
24  ==================  ==================
25  To install LBBS quickly, please do the following steps:  See guide in [INSTALL.md](INSTALL.md)  
26    
 0) Prerequisite    
    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.  
27    
28  1) Extract the source files from a tarball or export from GitHub    Tutorial
29     Run the following command to set up the autoconf/automake environment,    ==================
30     sh ./autogen.sh    Watch demos and keynotes in [Tutorial.md](Tutorial.md)  
    and fix any error if exists.  
   
 2) Compile source files    
    ./configure --prefix=/usr/local/lbbs    
    make  
   
 3) Create user and group    
    sudo useradd bbs  
   
 4) Install binary files and data files    
    sudo make install  
   
 5) Modify following configuration files    
    Default configuration files is saved as *.default, you should rename them first.    
    /usr/local/lbbs/conf/bbsd.conf    
    /usr/local/lbbs/utils/conf/db_conn.inc.php    
31    
 6) Generate menu configuration file with section data by running the script    
    sudo -u bbs php /usr/local/lbbs/utils/bin/gen_section_menu.php    
    sudo -u bbs php /usr/local/lbbs/utils/bin/gen_ex_list.php    
32    
33  7) Create or copy SSH2 RSA certificate into /usr/local/lbbs/conf    Copyright
34     ssh-keygen -t rsa -C "Your Server Name" -f ssh_host_rsa_key  =================
35    Copyright (C) 2004-2026 Leaflet <leaflet@leafok.com>  
36    
 8) Startup    
    sudo /usr/local/lbbs/bin/bbsd  
37    
38  9) Set up systemd    License
39     Create your own /usr/lib/systemd/system/lbbs.service from the sample at conf/lbbs.service.default, and make any change if necessary.    ==================
40     Reload daemon config and start the service.    This program is free software; you can redistribute it and/or modify
41    it under the terms of the [GNU General Public License](LICENSE) as published by
42    the Free Software Foundation; either version 3 of the License, or    
43    (at your option) any later version.  

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