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

Contents of /lbbs/README.md

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.15 - (show annotations)
Wed Jul 9 01:51:55 2025 UTC (8 months, 1 week ago) by sysadm
Branch: MAIN
Changes since 1.14: +5 -1 lines
Content type: text/markdown
Add screen snapshots into README.md

1 # LBBS - Classical terminal server of LeafOK BBS
2
3 Copyright (C) 2004-2025 by Leaflet
4 Email : leaflet@leafok.com
5 Demo site : bbs.fenglin.info (Telnet 2323 / SSH2 2322)
6
7
8 Introduction
9 =================
10 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).
11 ![Welcome](misc/images/ssh_welcome.jpg "Welcome to LBBS")
12 ![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
18 ==================
19 1) GNU C Compiler
20 2) PHP ( Version >= 8.2 )
21 3) MySQL database ( Version >= 8.4 )
22
23
24 Quick Installation
25 ==================
26 To install LBBS quickly, please do the following steps:
27
28 0) Prerequisite
29 Follow README.md under https://github.com/leafok88/leafok_bbs to initialize the database structure shared by both web version and telnet version.
30 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
33 Run the following command to set up the autoconf/automake environment,
34 sh ./autogen.sh
35 and fix any error if exists.
36
37 2) Compile source files
38 ./configure --prefix=/usr/local/lbbs
39 make
40
41 3) Create user and group
42 sudo useradd bbs
43
44 4) Install binary files and data files
45 sudo make install
46
47 5) Modify following configuration files
48 Default configuration files is saved as *.default, you should rename them first.
49 /usr/local/lbbs/conf/bbsd.conf
50 /usr/local/lbbs/utils/conf/db_conn.inc.php
51
52 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
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
57 ssh-keygen -t rsa -C "Your Server Name" -f ssh_host_rsa_key
58
59 8) Startup
60 sudo /usr/local/lbbs/bin/bbsd
61
62 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.
64 Reload daemon config and start the service.

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