====== bbs.ini ======


This is the main bbs INI file and contains the following sections

===== Main =====

  * Codepage 
  
  The default codepage to use when a user logs in. (Required)

  * Telnet Port
  
  The port to listen to telnet connections on (Required)
  
  * BBS Name 
  
  The name of your BBS (Required)
  
  * Sysop Name
  
  The Sysop's Login Name (Required)
  
  * Nodes
  
  The maximum number of nodes (Required)
  
  * New User Level
  
  The security level new users are given (See s10.ini) (Required)
  
  * MagiChat Server
  
  The MagiChat Server you want to connect to (Optional)
  
  * MagiChat Port
  
  The port of the above MagiChat Server (Required if MagiChat Server is set);
  
  * MagiChat BBSTag
  
  The (short) tag to identify users of your BBS (Required if MagiChat Server 
  is set);
  
  * Default Tagline
  
  The tagline to use if a conference doesn't have it's own set
  
  * External Editor Cmd
  
  The script to launch for running an external editor (NOT Required - remove
  if you dont have one)
  
  * External Editor Stdio
  
  True or False if your editor requires stdio redirection (Only Required if
  External Editor CMD is set)
  
  * External Editor Codepage
  
  The codepage the external editor uses (CP437 for magiedit) (Only required
  if External Editor CMD is set)
  
  * Upload Checker
  
  Path and filename of an upload checking script. (Optional)
  
  * Upload Checker Codepage
  
  The codepage the upload check script uses.
  
  * Automessage Write Level
  
  The security level a user needs to change the automessage (Required)
  
  * Fork
  
  True if you want the BBS to run in daemon mode false if not. (Required)
  
  * Run as User
  
  Which user to run at if invoked as root. (Required if running as root)
  
  * Enable WWW
  
  True to enable the WWW server, false if not. (Required)
  
  * WWW Port
  
  Port to listen for HTTP connections (Required if WWW is enabled)
  
  * WWW URL
  
  Public facing url of the BBS (Required if WWW is enabled)
  
  * WWW SSL Cert

  Path and filename of your SSL certificate in PEM format (Not required)
  
  * WWW SSL Key
  
  Path and filename of your SSL private key

  * WWW SSL Only

  True if you only want SSL ie disable HTTP

  * WWW SSL Port

  Port for HTTPS to listen on

  * WWW SSL URL

  Public facing url of HTTPS

  * WWW SSL Redirect

  True if you want to redirect HTTP -> HTTPS

  * Enable SSH
  
  True to enable the SSH server, false to not. (Required)
  
  * SSH Port
  
  Port to listen for SSH connection. (Required if Enable SSH is true)
  
  * SSH DSA Key
  
  Path to SSH DSA Host Key. (Required if Enable SSH is true)
  
  * SSH RSA Key
  
  Path to SSH RSA Host Key. (Required if Enable SSH is true)
  
  * SSH ECDSA Key
  
  Path to SSH ECDSA Key. (Optional)
  
  * SSH ED25519 Key
  
  Path to SSH ED25519 Key. (Optional)
  
  * Main AKA
  
  Your main network address (Required)
  
  * QWK Name
  
  Name used for the system for Bluewave & QWK (Required - restricted to 8
  characters)
  
  * QWK Max Messages
  
  Maximum number of messages per Bluewave bundle (Required)
  
  * MQTT Enable
  
  Enables / Disables MQTT Messages (Required)
  
  * MQTT Port
  
  Port that your MQTT server listens on (Required if MQTT Enabled)
  
  * MQTT Address
  
  Address of your MQTT server (Required if MQTT Enabled)
  
  * MQTT Topic
  
  Topic your BBS publishes to (Required if MQTT Enabled)
  
  * MQTT User
  
  Username to login to your MQTT server (Optional)
  
  * MQTT Pass
  
  Password to login to your MQTT server (Optional)
  
  * IP Guard Enable 
  
  Set to true to enable the IP Guard (Required)
  
  * IP Guard Timeout
  
  Timeout between connections (Required)
  
  * IP Guard Tries
  
  Number of connections allowed within IP Guard Timeout (Required)
  
  * Root Menu
  
  The menu file for the "main menu" (Required)
  
  * Date Style
  
  The style for dates (EU or US) (Required)
  
  * Enable IPv6
  
  Enable listening on IPv6 as well as IPv4 (Required) 
  
  * New User Password
  
  Password to prompt for new users to be able to sign up. Max 32 Chars
  (Optional)

===== Colours =====

  * Message Quote Foreground
  
  The colour of quotes in displayed messages.
  
  * Message Quote Background
  
  The colour of the background of quotes in displayed messages.
  
  * Message Origin Foreground
  
  The colour of the origin lines in displayed messages.
  
  * Message Origin Background
  
  The colour of the background of the origin lines in displayed messages.

  Possible colours: black, blue, green, brown, red, white, magenta, cyan

  Foreground can also be bright.
  Background can not be bright.

  bright brown = yellow

===== Paths =====

  * Config Path
  
  Path to your config files (Required)
  
  * WWW Path
  
  Path to webserver files (Required)
  
  * String File
  
  Path and filename of the 'magicka.strings' file (Required)
  
  * ANSI Path
  
  Path to your system ansi files (Required)
  
  * BBS Path
  
  Path to your main BBS directory (Required)
  
  * Script Path
  
  Path to user configurable lua scripts (Required)
  
  * Echomail Semaphore
  
  Path to semaphore to create when a new echomail is written. (Required)
  
  * Netmail Semaphore
  
  Path to semaphore to create when a new netmail is written. (Required)
  
  * PID File
  
  Path of pid file (Required)
  
  * Log Path
  
  Path to log files (Required)
  
  * Menu Path
  
  Path to menu files (Required)
  
  * IPData Database
  
  Path and file name of an IP2Location BIN database (Optional)
  https://lite.ip2location.com/database/ip-country-region-city

===== Mail Conferences =====

  * Mail Conferences include a list of Name = Path to configuration INI (At
  least 1 is required)

===== File Directories =====

  * Same as Mail Conferences, but for files
 
===== Text Files =====

  * A list of text files with name = Path/Filename for text files in the text
  file collection
.