LeafOK_CVS/lbbs/INSTALL.md

Installation
==================
To install LBBS, please perform the following steps:

0) Prerequisite  
   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.   
   It is highly recommended to finish the configuration steps of web version first and make sure those features could work properly.

1) Common requirements  
   gcc >= 14.2.0  
   autoconf >= 2.68  
   automake >= 1.16  
   libssh >= 0.11.1
   PHP >= 8.2  
   MySQL >= 8.4

2) 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

3) Compile source files  
   ./configure --prefix=/usr/local/lbbs  
   make

4) Create user and group  
   sudo useradd bbs

5) Install binary files and data files  
   sudo make install

6) 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  

7) Generate menu configuration file with section data by running the script  
   sudo -u bbs php /usr/local/lbbs/utils/bin/gen_section_menu.php  
   sudo -u bbs php /usr/local/lbbs/utils/bin/gen_ex_list.php  

8) Create or copy SSH2 RSA certificate into /usr/local/lbbs/conf  
   ssh-keygen -t rsa -C "Your Server Name" -f ssh_host_rsa_key

9) Startup  
   sudo /usr/local/lbbs/bin/bbsd

10) Set up systemd  
   Create your own /usr/lib/systemd/system/lbbs.service from the sample at conf/lbbs.service.default, and make any change if necessary.  
   Reload daemon config and start the service.  
1	sysadm	1.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	sysadm	1.2	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	sysadm	1.1	Run the following command to set up the autoconf/automake environment,
19	sysadm	1.2	sh ./autogen.sh
20	sysadm	1.1
21	sysadm	1.2	3) Compile source files
22	sysadm	1.1	./configure --prefix=/usr/local/lbbs
23			make
24
25	sysadm	1.2	4) Create user and group
26	sysadm	1.1	sudo useradd bbs
27
28	sysadm	1.2	5) Install binary files and data files
29	sysadm	1.1	sudo make install
30
31	sysadm	1.2	6) Modify following configuration files
32	sysadm	1.1	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	sysadm	1.2	7) Generate menu configuration file with section data by running the script
37	sysadm	1.1	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	sysadm	1.2	8) Create or copy SSH2 RSA certificate into /usr/local/lbbs/conf
41	sysadm	1.1	ssh-keygen -t rsa -C "Your Server Name" -f ssh_host_rsa_key
42
43	sysadm	1.2	9) Startup
44	sysadm	1.1	sudo /usr/local/lbbs/bin/bbsd
45
46	sysadm	1.2	10) Set up systemd
47	sysadm	1.1	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