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
Andrew Pamment 6219d836ee Updated Documentation
2018-02-05 11:14:37 +10:00

1.6 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.

  • OpenBSD as of 6.2 does not have libmicrohttpd in ports, but current does. Requires libiconv.

  • OpenIndiana does not have libssh in packages, so it needs to be built separately. 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, bash and gnu make

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

should work on debian and debian derivatives.

Install Magicka

Clone the repo

git clone https://github.com/MagickaBBS/MagickaBBS

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 must be run on a port over 1024, the port can be configured in bbs.ini. Log on to your new bbs and create your sysop account!