| 1 |
# LBBS |
# LBBS - Classical terminal server of LeafOK BBS |
| 2 |
|
|
| 3 |
Copyright (C) 2004-2025 by Leaflet |
Copyright (C) 2004-2025 by Leaflet |
| 4 |
|
|
| 5 |
Email : leaflet@leafok.com |
Email : leaflet@leafok.com |
| 6 |
|
|
| 7 |
|
Demo site : bbs.fenglin.info (Telnet 2323 / SSH2 2322) |
| 8 |
|
|
| 9 |
Introduction |
Introduction |
| 10 |
================= |
================= |
| 35 |
================== |
================== |
| 36 |
To install LBBS quickly, please do the following steps: |
To install LBBS quickly, please do the following steps: |
| 37 |
|
|
| 38 |
|
0) Prerequisite |
| 39 |
|
|
| 40 |
|
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. |
| 41 |
|
|
| 42 |
1) Extract the source files from a tarball or export from GitHub |
1) Extract the source files from a tarball or export from GitHub |
| 43 |
|
|
| 44 |
Run the following command to set up the autoconf/automake environment, |
Run the following command to set up the autoconf/automake environment, |
| 53 |
|
|
| 54 |
make |
make |
| 55 |
|
|
| 56 |
3) Install binary files and data files |
3) Create user and group |
| 57 |
|
|
| 58 |
make install |
sudo useradd bbs |
| 59 |
|
|
| 60 |
4) Create user and group |
4) Install binary files and data files |
| 61 |
|
|
| 62 |
groupadd bbs |
sudo make install |
| 63 |
|
|
| 64 |
useradd bbs |
5) Modify following configuration files |
| 65 |
|
|
| 66 |
5) Set privileges of files |
Default configuration files is saved as *.default, you should rename them first. |
| 67 |
|
|
| 68 |
|
/usr/local/lbbs/conf/bbsd.conf |
| 69 |
|
|
| 70 |
|
/usr/local/lbbs/utils/conf/db_conn.inc.php |
| 71 |
|
|
| 72 |
cd /usr/local/lbbs |
6) Generate menu configuration file with section data by running the script |
| 73 |
|
|
| 74 |
chown bbs:bbs -R lbbs |
sudo -u bbs php /usr/local/lbbs/utils/bin/gen_section_menu.php |
| 75 |
|
|
| 76 |
chmod 750 -R lbbs |
7) Create or copy SSH2 RSA certificate into /usr/local/lbbs/conf |
| 77 |
|
|
| 78 |
chmod 4750 lbbs/bin/bbsd |
ssh-keygen -t rsa -C "Your Server Name" -f ssh_host_rsa_key |
| 79 |
|
|
| 80 |
6) Modify following configuration files |
8) Startup |
| 81 |
|
|
| 82 |
Default configuration files is saved as *.default, you should rename them first. |
sudo /usr/local/lbbs/bin/bbsd |
| 83 |
|
|
| 84 |
/usr/local/lbbs/conf/bbsd.conf |
9) Set up systemd |
| 85 |
|
|
| 86 |
/usr/local/lbbs/utils/conf/db_conn.inc.php |
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. |
| 87 |
|
|
| 88 |
|
Run the following bash command to startup the service: |
| 89 |
|
|
| 90 |
7) Startup |
sudo systemctl daemon-reload |
| 91 |
|
|
| 92 |
/usr/local/lbbs/bin/bbsd |
sudo systemctl start lbbs |
| 93 |
|
|
Parent Directory
| 
Revision Log
| 
Patch