| 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 (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. |
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. |
|
Thank you for using this software. If you meet any bugs or have any suggestion, please tell me. |
|
| 12 |
|
|
| 13 |
|
|
| 14 |
System Requirement |
System Requirement |
| 15 |
================== |
================== |
| 16 |
1) GNU C Compiler |
1) GNU C Compiler |
| 17 |
2) PHP ( Version >= 8.2 ) |
2) PHP ( Version >= 8.2 ) |
| 18 |
3) MySQL database ( Version >= 8.4 ) |
3) MySQL database ( Version >= 8.4 ) |
| 19 |
|
|
| 20 |
|
|
| 21 |
Quick Installation |
Quick Installation |
| 22 |
================== |
================== |
| 23 |
To install LBBS quickly, please do the following steps: |
To install LBBS quickly, please do the following steps: |
| 24 |
|
|
| 25 |
0) Prerequisite |
0) Prerequisite |
| 26 |
|
Follow README.md under https://github.com/leafok88/leafok_bbs to initialize the database structure shared by both web version and telnet version. |
| 27 |
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. |
| 28 |
|
|
| 29 |
1) Extract the source files from a tarball or export from GitHub |
1) Extract the source files from a tarball or export from GitHub |
| 30 |
Run the following command to set up the autoconf/automake environment, |
Run the following command to set up the autoconf/automake environment, |
| 44 |
5) Modify following configuration files |
5) Modify following configuration files |
| 45 |
Default configuration files is saved as *.default, you should rename them first. |
Default configuration files is saved as *.default, you should rename them first. |
| 46 |
/usr/local/lbbs/conf/bbsd.conf |
/usr/local/lbbs/conf/bbsd.conf |
| 47 |
/usr/local/lbbs/utils/conf/db_conn.inc.php |
/usr/local/lbbs/utils/conf/db_conn.inc.php |
| 48 |
|
|
| 49 |
6) Generate menu configuration file with section data by running the script |
6) Generate menu configuration file with section data by running the script |
| 50 |
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 |
| 51 |
sudo -u bbs php /usr/local/lbbs/utils/bin/gen_ex_list.php |
sudo -u bbs php /usr/local/lbbs/utils/bin/gen_ex_list.php |
| 52 |
|
|
| 53 |
7) Create or copy SSH2 RSA certificate into /usr/local/lbbs/conf |
7) Create or copy SSH2 RSA certificate into /usr/local/lbbs/conf |
| 54 |
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 |