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.
magicka/docs/docs/guide/installation.md

1.9 KiB
Raw Blame History

Installation

Platform Specific Notes

  • FreeBSD requires libiconv to be installed from ports in addition to other dependencies.

  • macOS makefiles are intended to be built with dependencies provided by macports, homebrew support will require significant changes.

  • NetBSD requires libiconv to be installed from pkgsrc in addition to other dependencies. Mosquitto should be installed from pkgsrc/wip.

  • OpenBSD also requires libiconv.

  • OpenIndiana does not have libssh or mosquitto in packages, so they need to be built separately, mosquitto requires c-ares. Requires libiconv.

  • DragonFlyBSD also requires libiconv.

Install Prerequisites

Ensure you have git, c compiler, libsqlite3-dev, libreadline-dev, libssl-dev, libssh-dev libncurses5-dev, libmicrohttpd-dev, libmosquitto-dev, bash, libdbd-sqlite3-perl, gnu sed and gnu make

sudo apt-get install build-essential libsqlite3-dev libreadline-dev git libssl-dev libssh-dev libncurses5-dev libmicrohttpd-dev libdbd-sqlite3-perl libmosquitto-dev libtool m4 sed automake

should work on debian and debian derivatives.

Install Magicka

Clone the repo and checkout the branch you want, eg. v0.11-patch.

git clone git://git.magickabbs.com/MagickaBBS

cd MagickaBBS

git checkout v0.11-patch

git submodule init
git submodule update

Build the BBS

make www

Run setup.sh and answer the questions to install the initial configurations

./setup.sh

If you are going to run SSH, you will need to create keys. To do this

mkdir keys

ssh-keygen -f keys/ssh_host_rsa_key -N '' -t rsa

ssh-keygen -f keys/ssh_host_dsa_key -N '' -t dsa

Run Magicka

Run BBS

./magicka config/bbs.ini

The BBS will run by default on telnet only and on port 2023. Magicka may be run on a port under 1025, however additional configuration is required and not really recommended, the port can be configured in bbs.ini. Log on to your new bbs and create your sysop account!