2016-03-22 01:58:52 +00:00
|
|
|
# MagickaBBS
|
2016-04-09 06:17:07 +00:00
|
|
|
Linux/FreeBSD bulletin board system (Should also work on NetBSD and OpenBSD, if it doesn't it's a bug)
|
2016-03-22 01:58:52 +00:00
|
|
|
|
2016-04-09 06:17:07 +00:00
|
|
|
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
|
2016-03-22 01:58:52 +00:00
|
|
|
lose it again!
|
|
|
|
|
|
2016-04-03 05:26:25 +00:00
|
|
|
Magicka is meant to be a modern (haha) BBS system, using modern technologies, like Sqlite, IRC, long filenames (gasp!) etc
|
2016-03-22 01:58:52 +00:00
|
|
|
while still retaining the classic BBS feel. ANSI & Telnet, and good old ZModem.
|
|
|
|
|
|
2016-03-23 08:34:34 +00:00
|
|
|
If you want to install Magicka BBS, follow these steps.
|
|
|
|
|
|
|
|
|
|
1. Ensure you have git, c compiler, sqlite-dev and gnu make
|
2016-03-23 08:43:44 +00:00
|
|
|
2. Clone the repo `git clone https://github.com/apamment/MagickaBBS`
|
2016-04-09 09:30:28 +00:00
|
|
|
|
|
|
|
|
2a. This is the master branch, it's recommended to check out the 0.1 branch
|
|
|
|
|
cd MagickaBBS/`
|
|
|
|
|
git checkout 0.1
|
|
|
|
|
|
|
|
|
|
|
2016-03-23 08:34:34 +00:00
|
|
|
3. Build JamLib
|
|
|
|
|
|
2016-03-25 00:58:57 +00:00
|
|
|
`cd MagickaBBS/jamlib`
|
2016-03-23 08:41:45 +00:00
|
|
|
|
2016-03-25 00:58:57 +00:00
|
|
|
|
2016-04-09 06:17:07 +00:00
|
|
|
`make -f Makefile.linux` (Linux) `gmake -f Makefile.linux` (*BSD)
|
2016-03-25 00:58:57 +00:00
|
|
|
|
2016-04-03 01:07:20 +00:00
|
|
|
3. Build libzmodem
|
|
|
|
|
|
|
|
|
|
`cd MagickaBBS/Xmodem`
|
|
|
|
|
|
|
|
|
|
|
2016-04-09 06:17:07 +00:00
|
|
|
`make` (Linux) `gmake` (*BSD)
|
2016-03-23 08:34:34 +00:00
|
|
|
|
2016-04-03 01:07:20 +00:00
|
|
|
5. Build the BBS (You may have to adjust the Makefile for your system)
|
2016-03-23 08:34:34 +00:00
|
|
|
|
2016-04-09 06:17:07 +00:00
|
|
|
`make` (Linux) `gmake` (*BSD)
|
|
|
|
|
|
2016-04-03 01:07:20 +00:00
|
|
|
6. Copy the config-default directory to a config directory.
|
2016-03-23 08:34:34 +00:00
|
|
|
|
2016-03-23 08:40:40 +00:00
|
|
|
`cp -r config-default config`
|
2016-03-23 08:34:34 +00:00
|
|
|
|
2016-04-03 01:07:20 +00:00
|
|
|
7. Edit the config files and update essential information, like system paths and BBS name etc
|
|
|
|
|
8. Copy the ansi-default directory to the one specified in your system path
|
2016-03-23 08:34:34 +00:00
|
|
|
|
2016-03-23 08:41:45 +00:00
|
|
|
eg.
|
2016-03-23 08:34:34 +00:00
|
|
|
|
2016-03-23 08:41:45 +00:00
|
|
|
`cp -r ansi-default ansi`
|
2016-03-23 08:34:34 +00:00
|
|
|
|
2016-04-03 01:07:20 +00:00
|
|
|
9. Run Magicka BBS on a port over 1024 (Below require root, and we're not ready for that).
|
2016-03-23 08:34:34 +00:00
|
|
|
|
2016-03-23 08:40:40 +00:00
|
|
|
`./magicka config/bbs.ini 2300`
|
2016-03-23 08:34:34 +00:00
|
|
|
|
2016-04-03 01:07:20 +00:00
|
|
|
10. 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,
|
2016-03-23 08:52:31 +00:00
|
|
|
but you will need to use an SQLite Manager to modify users.sq3 and set security levels, as there is no user editor yet.
|
2016-04-09 06:17:07 +00:00
|
|
|
|
|
|
|
|
For information on how to configure your BBS, check the wiki https://github.com/apamment/MagickaBBS/wiki
|
