Videotex BBS - a combination of Videotex and BBS technologies. This project has been moved into clrghouz.
This repository has been archived on 2024-04-08. You can view files and clone it, but cannot push or open issues or pull requests.
Go to file
2019-10-02 15:47:56 +10:00
app More work on Edit Frame 2019-10-02 15:47:56 +10:00
bootstrap Re-engineered with Laravel 2018-12-02 01:51:31 +04:00
config Internal rework pending editframe 2019-07-12 10:42:01 +07:00
data Increase page length for ANSI, and minor updates 2019-01-02 20:56:03 +11:00
database Increase page length for ANSI, and minor updates 2019-01-02 20:56:03 +11:00
public Re-engineered with Laravel 2018-12-02 01:51:31 +04:00
resources/views Enabled user registration 2018-12-25 12:48:57 +11:00
routes Added some missing required config files 2018-12-06 16:24:48 +11:00
storage Re-engineered with Laravel 2018-12-02 01:51:31 +04:00
.env.example Re-engineered with Laravel 2018-12-02 01:51:31 +04:00
.gitattributes Increase page length for ANSI, and minor updates 2019-01-02 20:56:03 +11:00
.gitignore Re-engineered with Laravel 2018-12-02 01:51:31 +04:00
artisan Re-engineered with Laravel 2018-12-02 01:51:31 +04:00
composer.json Enabled user registration 2018-12-25 12:48:57 +11:00
composer.lock Enabled user registration 2018-12-25 12:48:57 +11:00
package.json Re-engineered with Laravel 2018-12-02 01:51:31 +04:00
phpunit.xml Re-engineered with Laravel 2018-12-02 01:51:31 +04:00
README.md Fixed markdown 2018-12-06 11:28:48 +00:00
server.php Re-engineered with Laravel 2018-12-02 01:51:31 +04:00

Installing vBBS

TL;DR - use docker :)

Figure out where you will install this - can be anywhere, call this $APP_DIR

Setup a MYSQL/MARIADB database

For docker, you can use the mariadb:latest image:

docker run --rm -itd --name=vbbs_db \
-v ${APP_DIR}/database:/var/lib/mysql \
-e MYSQL_ROOT_PASSWORD=secret -e MYSQL_USER=user -e MYSQL_PASSWORD=password -e MYSQL_DATABASE=database mariadb:latest

Check that docker started OK, it should look something like this (use docker ps):

CONTAINER ID        IMAGE                                         COMMAND                  CREATED             STATUS              PORTS                                            NAMES
fc2f32aaaa55        mariadb:10.3                                  "docker-entrypoint.s…"   4 seconds ago       Up 3 seconds        3306/tcp                                         vbbs_db

Clone the git repository

mkdir -p ${APP_DIR}/composer
mkdir -p ${APP_DIR}/app
cd ${APP_DIR}/app
git clone http://dev.leenooks.net/bbs/vbbs.git .

(chown -R 33:33 ${APP_DIR}/composer ${APP_DIR}/app dirs if you use my docker image)

** Setup the application cd ${APP_DIR}/app cp .env.example to .env

edit and update the APP_PORT (something above 1024) and DB_* database entries:

APP_PORT=6502
...
DB_CONNECTION=mysql
DB_HOST=vbbs_db
DB_PORT=3306
DB_DATABASE=database
DB_USERNAME=user
DB_PASSWORD=password

Setup PHP

You're PHP will need SOCKETS and PCNTL and you'll need COMPOSER as well installed.

If you are using docker, you can use my PHP image, which has all three.

Pre Setup

You need to run composer, and migrate to test connectivity to the database and seed it - you can do that in a single step

docker run --rm -u www-data -itd --link=vbbs_db --name=vbbs \
-v ${APP_DIR}/app/php:/var/www/html \
-v ${APP_DIR}/composer:/var/www/.composer/cache \
--entrypoint=/bin/bash registry.leenooks.net/leenooks/php:7.2-fpm-plus -c "composer install; php artisan migrate --seed"

Start

Now, run the app, you need to map it from the host port (can be anything), into the container onto APP_PORT that you specified above.

For example, if you use 6502 for both:

docker run --rm -u www-data -itd --link=vbbs_db --name=vbbs -p 6502:6502 \
-v ${APP_DIR}/app/php:/var/www/html \
-v ${APP_DIR}/composer:/var/www/.composer/cache \
--entrypoint=/bin/bash registry.leenooks.net/leenooks/php:7.2-fpm-plus -c "php artisan server"

If you want to watch is on the console, you can remove the d from the option or use docker attach

If it started OK, you should see it running (use docker ps):

CONTAINER ID        IMAGE                                             COMMAND                  CREATED             STATUS              PORTS                                            NAMES
9916ee39d9b7        registry.leenooks.net/leenooks/php:7.2-fpm-plus   "/bin/bash -c 'php a…"   13 minutes ago      Up 13 minutes       22/tcp, 9000/tcp, 0.0.0.0:6502->6502/tcp          vbbs

Voila!

Use your videotex terminal and connect to your host on the APP_PORT that you used (eg: 6502)