bbs/magicka
Archived
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
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.
d03ed16507
magicka/README.md
Andrew Pamment 8de8a9c090 Try to fix the readme again.
2016-08-05 19:55:14 +10:00

2.5 KiB
Raw Blame History

README!!

If you are upgrading from a version prior to 73aa146b84 You will need to make and run the update_pass utility on your user database. This will convert all plain text passwords to sha256 hashed and salted passwords.

eg.

	cd utils/update_pass
	make
	./update_pass ../../users.sq3

Although you probably should make a backup of your database first in case things go wrong...

MagickaBBS

Linux/FreeBSD bulletin board system (Should also work on NetBSD and OpenBSD, if it doesn't it's a bug)

As I lost the code to my initial BBS flea, I've decided to start over from scratch and this time I'm using git hub so I dont lose it again!

Magicka is meant to be a modern (haha) BBS system, using modern technologies, like Sqlite3, IRC, long filenames (gasp!) etc while still retaining the classic BBS feel. ANSI & Telnet, and good old ZModem.

If you want to install Magicka BBS, follow these steps.

  1. Ensure you have git, c compiler, libsqlite3-dev, libreadline-dev, libssl-dev and gnu make

    sudo apt-get install build-essential libsqlite3-dev libreadline-dev git libssl-dev

    should work on debian and debian derivatives.

  2. Clone the repo git clone https://github.com/apamment/MagickaBBS

  3. Build JamLib

cd MagickaBBS/jamlib

make -f Makefile.linux (Linux) gmake -f Makefile.linux (*BSD)

  1. Build libzmodem

cd MagickaBBS/Xmodem

make (Linux) gmake (*BSD)

  1. Build LUA

    cd MagickaBBS/lua

    make linux (Linux) gmake freebsd (FreeBSD)

  2. Build the BBS (You may have to adjust the Makefile for your system)

make -f Makefile.linux (Linux) gmake -f Makefile.freebsd (FreeBSD)

  1. Make a directory for logs.

    mkdir logs

  2. Copy the config-default directory to a config directory.

cp -r config_default config

  1. Edit the config files and update essential information, like system paths and BBS name etc
  2. Copy the ansi-default directory to the one specified in your system path

eg.

cp -r ansi_default ansis

  1. Run Magicka BBS on a port over 1024 (Below require root, and we're not ready for that).

./magicka config/bbs.ini 2300

  1. Your BBS is now running on port 2300, log in and create yourself an account! (By default there is only one security level, you can add more, but you will need to use an SQLite Manager to modify users.sq3 and set security levels, as there is no user editor yet.

For information on how to configure your BBS, check the wiki https://github.com/apamment/MagickaBBS/wiki