| 1 |
Installation |
Installation |
| 2 |
================== |
================== |
| 3 |
To install LBBS, please perform the following steps: |
To install LBBS on Linux (e.g. Debian 13, CentOS Stream 10), please perform the following steps: |
| 4 |
|
|
| 5 |
0) Prerequisite |
0) Prerequisite |
| 6 |
Follow README.md under [leafok_bbs](https://github.com/leafok/leafok_bbs) to initialize the database structure shared by both web version and telnet version. |
Follow README.md under [leafok_bbs](https://github.com/leafok/leafok_bbs) to initialize the database structure shared by both web version and telnet version. |
| 48 |
sudo -u bbs $LBBS_HOME_DIR/bin/bbsd |
sudo -u bbs $LBBS_HOME_DIR/bin/bbsd |
| 49 |
|
|
| 50 |
11) (Optional) Set up systemd |
11) (Optional) Set up systemd |
| 51 |
|
Enable systemd related feature during config, by running: |
| 52 |
|
./configure --prefix=$LBBS_HOME_DIR --enable-systemd |
| 53 |
Create your own /usr/lib/systemd/system/lbbs.service from the sample at conf/lbbs.service, and make any change if necessary. |
Create your own /usr/lib/systemd/system/lbbs.service from the sample at conf/lbbs.service, and make any change if necessary. |
| 54 |
Reload daemon config and start the service. |
Reload daemon config and start the service. |
| 55 |
|
|
| 63 |
There should be no item owned by bbs. Otherwise, run the following command to cleanup: |
There should be no item owned by bbs. Otherwise, run the following command to cleanup: |
| 64 |
sudo -u bbs ipcrm -a |
sudo -u bbs ipcrm -a |
| 65 |
|
|
| 66 |
|
|
| 67 |
|
For Cygwin User |
| 68 |
|
================== |
| 69 |
|
Installation of LBBS on Cygwin is similar to the above steps for Linux, except that: |
| 70 |
|
|
| 71 |
|
a. Use additional config switches to keep compatible with the Cygwin environment. |
| 72 |
|
./configure --prefix=$LBBS_HOME_DIR --with-mariadb --without-epoll |
| 73 |
|
|
| 74 |
|
b. Enable Cygserver with optimized parameters (as large as possible) of XSI semaphore and shared memory in /etc/cygserver.conf |
| 75 |
|
|
| 76 |
|
c. Skip those steps not supported by Cygwin (e.g. systemd and logrotate). |