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

Contents of /lbbs/INSTALL.md

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.2 - (show annotations)
Mon Sep 22 06:21:40 2025 UTC (5 months, 3 weeks ago) by sysadm
Branch: MAIN
Changes since 1.1: +18 -11 lines
Content type: text/markdown
Add common requirements

1 Installation
2 ==================
3 To install LBBS, please perform the following steps:
4
5 0) Prerequisite
6 Follow README.md under [leafok_bbs](https://github.com/leafok88/leafok_bbs) to initialize the database structure shared by both web version and telnet version.
7 It is highly recommended to finish the configuration steps of web version first and make sure those features could work properly.
8
9 1) Common requirements
10 gcc >= 14.2.0
11 autoconf >= 2.68
12 automake >= 1.16
13 libssh >= 0.11.1
14 PHP >= 8.2
15 MySQL >= 8.4
16
17 2) Extract the source files from a tarball or export from GitHub
18 Run the following command to set up the autoconf/automake environment,
19 sh ./autogen.sh
20
21 3) Compile source files
22 ./configure --prefix=/usr/local/lbbs
23 make
24
25 4) Create user and group
26 sudo useradd bbs
27
28 5) Install binary files and data files
29 sudo make install
30
31 6) Modify following configuration files
32 Default configuration files is saved as *.default, you should rename them first.
33 /usr/local/lbbs/conf/bbsd.conf
34 /usr/local/lbbs/utils/conf/db_conn.inc.php
35
36 7) Generate menu configuration file with section data by running the script
37 sudo -u bbs php /usr/local/lbbs/utils/bin/gen_section_menu.php
38 sudo -u bbs php /usr/local/lbbs/utils/bin/gen_ex_list.php
39
40 8) Create or copy SSH2 RSA certificate into /usr/local/lbbs/conf
41 ssh-keygen -t rsa -C "Your Server Name" -f ssh_host_rsa_key
42
43 9) Startup
44 sudo /usr/local/lbbs/bin/bbsd
45
46 10) Set up systemd
47 Create your own /usr/lib/systemd/system/lbbs.service from the sample at conf/lbbs.service.default, and make any change if necessary.
48 Reload daemon config and start the service.

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