
     .--------------------------------.
     | Mystic BBS Linux / OSX Manual  |------------------------------------
     `--------------------------------'

        INSTALLATION
        ============

	This document needs to be rewritten.  The basic stuff you need to be
        concerned with is:
 
          1) Proper font configuration for your terminal (if using locally)
          2) Proper security rights for your operation system/user

        In the meantime:

	Type ./install to install Mystic BBS.

        If you are logged into an account that does not have OS access to
        create a directory where you want to install then you will need to
        execute the installation using SUDO (this is most likely the case
        and the install program will refuse/exit if you do not have access
        rights):
  
          sudo ./install

        If you DO need to use the sudo method you will need to CHOWN the
        directories and files after the installation.  Mystic installation
        will never try to adjust the security of your OS, so we leave it up
        to you to do that.

        For example, if the user name was "me" that executed the sudo install
        and you installed to /mystic/, you might do the following command
        so that the "me" user owns your mystic directory structure: 

          sudo chown -R me:me /mystic/

        The above command will give the ME user owner rights to the /mystic/
        directory tree, and the files contained in it.  Once you have done
        that, you can change to the directory where you installed to and do
        any of the following:

	Configuration:            ./mystic -cfg
	Local login:              ./mystic
	Startup servers:          ./mis
        Startup servers (daemon): ./mis -D


        TERMINAL SETTINGS
        =================

        If the terminal looks a little whacked out, its most likely because
        it is not configured with a good CP437 font.  CP437 is basically
        what was considered "US/DOS" characterset and should contain the
        upper ASCII characters that you would expect from a DOS-based
        system.

        One such font is called Nimbus Mono L which comes with a few
        different Linux distributions by default, but there are many others.


        OTHER NOTES
        ===========

	Mystic (MIS actually) has built in Telnet (with STDIO redirecting and
        telnet IAC escaping), SMTP, POP3, FTP, and NNTP servers... But...

	When running in Linux/OSX keep in mind that by default the
	operating system will not let a service bind to a port less than
	1024 unless it is a ROOT user.  This is a Linux thing, not a Mystic
        thing.

	If you are having trouble getting MIS to answer telnet connections,
	you may want to change the telnet port in the configuration to a
	port higher than 1024 to eliminate that its not an OS-level issue.

	Additionally, it is possible to use ddtelnet, inetd, etc, to server
	Mystic BBS telnet (or even dialup) connections.  Ideally whatever you
        use should execute Mystic with the -IP and -HOST command line options
        so that Mystic understands the IP address and HOST name of the
        connection.  If you are using dialup, you can use these to pass
        callerID information for example:

           ./mystic -IP212-555-5555 -HOSTuser@dialup

        Mystic stores the last-known connection by each user, so these are
        nice to have passed in, but not absolutely required.

        If you have anything to add to this please by all means contact us!
