| 1 |
# LBBS |
# LBBS - Classical terminal server of LeafOK BBS |
| 2 |
|
|
| 3 |
Copyright (C) 2004-2025 by Leaflet |
Chinese version of README.md is located at [README.zh_CN.md](README.zh_CN.md) |
| 4 |
|
|
| 5 |
Email : leaflet@leafok.com |
## Introduction |
| 6 |
|
|
| 7 |
|
This software aims to provide a telnet-based interface for a pure web-based BBS [leafok_bbs](https://github.com/leafok/leafok_bbs). |
| 8 |
|
|
| 9 |
Introduction |
Demo site: fenglin.info (Telnet 2323 / SSH2 2322) |
|
================= |
|
|
This software (named as LBBS) aims to providing a telnet-based interface for a pure web-based BBS (named as LeafOK BBS). |
|
| 10 |
|
|
| 11 |
LeafOK BBS is a powerful BBS system, not only providing almost every function that a standard BBS should have, but also giving many features other BBS hasn't complemented yet. |
 |
| 12 |
|
 |
| 13 |
|
 |
| 14 |
|
 |
| 15 |
|
|
| 16 |
As an open source project, LeafOK BBS use MySQL as its major data depository, and PHP as its developing language. With MySQL and PHP, LeafOK BBS becomes a platform-independent system. It can works stably on many popular Web Servers such as Apache and IIS. |
## System Requirements |
| 17 |
|
|
| 18 |
However, as a pure web-based BBS, its shortage is inevitable. For LeafOK BBS uses Browser/Server as its architecture, it will cause more data traffic between Users and Server than telnet-based BBS, and its response is a little slower than telnet-based BBS. |
1. GNU C Compiler |
| 19 |
|
2. PHP (version 8.2 or higher) |
| 20 |
|
3. MySQL database (version 8.4 or higher) |
| 21 |
|
|
| 22 |
In order to conquer these shortage, a new project was launched. LBBS is a telnet-based BBS which is full compatible with LeafOK BBS. It also uses MySQL as its data repository, and keep coherence with the data structure of LeafOK BBS. LBBS is designed to be a system running on Linux, with GNU C as its developing language. |
## Installation |
| 23 |
|
|
| 24 |
Thank you for using this software. If you meet any bugs or have any suggestion, please tell me. |
See guide in [INSTALL.md](INSTALL.md) |
| 25 |
|
|
| 26 |
|
## Tutorial |
| 27 |
|
|
| 28 |
System Requirement |
Watch demos and keynotes in [Tutorial.md](Tutorial.md) |
|
================== |
|
|
Operation System: Linux |
|
| 29 |
|
|
| 30 |
Software: |
## Copyright |
|
1) GNU C Compiler |
|
|
2) PHP ( Version >= 8.2 ) |
|
|
3) MySQL database ( Version >= 8.4 ) |
|
| 31 |
|
|
| 32 |
|
Copyright (C) 2004-2026 Leaflet <leaflet@leafok.com> |
| 33 |
|
|
| 34 |
Quick Installation |
## License |
|
================== |
|
|
To install LBBS quickly, please do the following steps: |
|
|
|
|
|
1) Extract the source files from a tarball or export from GitHub |
|
|
|
|
|
Run the following command to set up the autoconf/automake environment, |
|
|
|
|
|
sh ./autogen.sh |
|
|
|
|
|
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 |
|
|
|
|
|
6) Startup |
|
|
|
|
|
sudo /usr/local/lbbs/bin/bbsd |
|
|
|
|
|
7) Set up systemd |
|
|
|
|
|
Create your own /usr/lib/systemd/system/lbbs.service from 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. |
|
|
|
|
|
Run the following bash command to startup the service: |
|
|
|
|
|
systemctl daemon-reload |
|
|
|
|
|
systemctl start lbbs |
|
| 35 |
|
|
| 36 |
|
This program is free software; you can redistribute it and/or modify |
| 37 |
|
it under the terms of the [GNU General Public License](LICENSE) as published by |
| 38 |
|
the Free Software Foundation; either version 3 of the License, or |
| 39 |
|
(at your option) any later version. |
Parent Directory
| 
Revision Log
| 
Patch