INSTALL en - ptt/pttbbs GitHub Wiki

Quick Installation

Install System dpkgs by root:

apt-get -y git bmake clang ccache libevent-dev pkg-config

Use root

Goal:

  • Add bbs and bbsadm as user with same uid (9999).
  • group-name: bbs
  • gid: 99
  • home directory: /home/bbs
  • shell for bbsadm: /bin/sh (or /bin/bash, /bin/csh, etc)
  • shell for bbs: /home/bbs/bin/bbsrf
  • bbsadm: with password
  • bbs: no password

You can use adduser and related commands to achieve the goal.

Example for Debian / Ubuntu:

  1. vipw and add the following two lines:

    bbs::9999:99:PttBBS,,,:/home/bbs:/home/bbs/bin/bbsrf
bbsadm::9999:99:PttBBS,,,:/home/bbs:/bin/bash

  2. passwd bbsadm

  3. add the following line in /etc/group:

    bbs:x:99:

  4. mkdir -p /home/bbs

  5. chown -R bbs:bbs /home/bbs

  6. chmod 700 /home/bbs

Use bbsadm

In /home/bbs:

  1. git clone http://github.com/ptt/pttbbs

  2. cd /home/bbs/pttbbs

  3. cp sample/pttbbs.conf pttbbs.conf

  4. Change pttbbs.conf based on your need. Uncomment the following two lines if you are in 64-bit Linux OS:

    #define SHMALIGNEDSIZE (1048576*4) //for 64-bit Linux OS
#define TIMET64                    //for 64-bit OS

  5. (If you are in linux: alias make=pmake)

    make all install clean

  6. If you are setting up a new site:

    cd sample; make install
cd /home/bbs; bin/initbbs -DoIt

Start BBS

  1. /home/bbs/bin/shmctl init

  2. Use root to do the following:

    /home/bbs/bin/mbbsd -p 23 -d

  3. Test with the following:

    telnet localhost 23

  4. new a bbs-account named SYSOP

  5. logout and then re-login as SYSOP, then you have SYSOP privilege.

  • Thanks to : chhsiao1981@github