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

Contents of /lbbs/INSTALL.md

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.1 - (show annotations)
Tue Aug 26 03:05:26 2025 UTC (6 months, 3 weeks ago) by sysadm
Branch: MAIN
Content type: text/markdown
Move installation guide to INSTALL.md

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) Extract the source files from a tarball or export from GitHub
10 Run the following command to set up the autoconf/automake environment,
11 sh ./autogen.sh
12 and fix any error if exists.
13
14 2) Compile source files
15 ./configure --prefix=/usr/local/lbbs
16 make
17
18 3) Create user and group
19 sudo useradd bbs
20
21 4) Install binary files and data files
22 sudo make install
23
24 5) Modify following configuration files
25 Default configuration files is saved as *.default, you should rename them first.
26 /usr/local/lbbs/conf/bbsd.conf
27 /usr/local/lbbs/utils/conf/db_conn.inc.php
28
29 6) Generate menu configuration file with section data by running the script
30 sudo -u bbs php /usr/local/lbbs/utils/bin/gen_section_menu.php
31 sudo -u bbs php /usr/local/lbbs/utils/bin/gen_ex_list.php
32
33 7) Create or copy SSH2 RSA certificate into /usr/local/lbbs/conf
34 ssh-keygen -t rsa -C "Your Server Name" -f ssh_host_rsa_key
35
36 8) Startup
37 sudo /usr/local/lbbs/bin/bbsd
38
39 9) Set up systemd
40 Create your own /usr/lib/systemd/system/lbbs.service from the sample at conf/lbbs.service.default, and make any change if necessary.
41 Reload daemon config and start the service.

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