Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
config:sbbs.ini [2010/02/23 00:15] – digitalman | config:sbbs.ini [2023/11/22 20:53] – [[Global]] Add TLSErrorLevel digital man | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== | + | ====== |
- | The Synchronet BBS (SBBS) Initialization File is the mother of all Synchronet configuration files and is located in the '' | + | The Synchronet BBS (SBBS) Initialization File ('' |
===== Filename ===== | ===== Filename ===== | ||
Line 7: | Line 7: | ||
The base filename of the initialization file is '' | The base filename of the initialization file is '' | ||
- | The standard host/ | + | The standard host/ |
===== Defaults ===== | ===== Defaults ===== | ||
- | Download or view the default '' | + | Download or view the default '' |
===== Editing ===== | ===== Editing ===== | ||
- | When using the Synchronet-Win32 Control Panel, the contents of this file are automatically updated when any of the configuration changes are made in the File-> | + | When using the [[monitor: |
If a sysop needs to edit the file by hand, any decent text file editor should do the job. See [[INI files]] for more details. | If a sysop needs to edit the file by hand, any decent text file editor should do the job. See [[INI files]] for more details. | ||
Line 24: | Line 24: | ||
==== [Global] ==== | ==== [Global] ==== | ||
+ | |||
+ | The '' | ||
+ | |||
+ | The supported '' | ||
+ | |||
+ | ^ Key ^ Default | ||
+ | | HostName | ||
+ | | Interface | ||
+ | | OutboundInterface | ||
+ | | LogLevel | ||
+ | | TLSLogLevel | ||
+ | | BindRetryCount | ||
+ | | BindRetryDelay | ||
+ | | CtrlDirectory | ||
+ | | TempDirectory | ||
+ | | SemFileCheckFrequency | ||
+ | | LoginAttemptDelay | ||
+ | | LoginAttemptThrottle | ||
+ | | LoginAttemptHackThreshold | ||
+ | | LoginAttemptTempBanThreshold | 20 | Default number of failed login attempts before temporarily banning IP address | | ||
+ | | LoginAttemptTempBanDuration | ||
+ | | LoginAttemptFilterThreshold | ||
+ | | AnswerSound | ||
+ | | LoginSound | ||
+ | | LogoutSound | ||
+ | | HangupSound | ||
+ | | HackAttemptSound | ||
+ | | JavaScript* | ||
+ | |||
+ | **More details on keys follow**: | ||
+ | |||
+ | === HostName === | ||
+ | |||
+ | Default: < | ||
+ | |||
+ | The public Internet DNS host name of this server. | ||
+ | |||
+ | If not set, the host name configured in '' | ||
+ | |||
+ | **Note**: | ||
+ | The '' | ||
+ | |||
+ | === Interface === | ||
+ | |||
+ | Default: '' | ||
+ | |||
+ | The IPv4 and/or IPv6 addresses of the network interfaces to listen on for incoming TCP/IP connections. | ||
+ | |||
+ | If multiple addresses are specified, they are to be separated by commas (this is true of all the '' | ||
+ | |||
+ | The address value '' | ||
+ | |||
+ | If this value is not set, any and all IPv4 and IPv6 network interfaces available will be listened to for incoming connections. | ||
+ | |||
+ | **Note**: | ||
+ | Although TCP port numbers may be specified (with ''//< | ||
+ | |||
+ | === OutboundInterface === | ||
+ | |||
+ | Default: '' | ||
+ | |||
+ | The IPv4 address of the network interface to use for outgoing TCP/IP connections. | ||
+ | |||
+ | === CtrlDirectory === | ||
+ | |||
+ | Default: '' | ||
+ | |||
+ | Specify the location of the Synchronet '' | ||
+ | |||
+ | === TempDirectory === | ||
+ | |||
+ | Default: '' | ||
+ | |||
+ | Override the default system " | ||
+ | If you do override this, do NOT use the system-wide temp dir (e.g.: ''/ | ||
+ | |||
+ | **Note**: | ||
+ | The '' | ||
+ | |||
+ | === SemFileCheckFrequency === | ||
+ | |||
+ | Default: '' | ||
+ | Minimum: '' | ||
+ | |||
+ | The interval, in seconds, betweeen [[semfiles|semaphore file]] checks. If you want to reduce the amount of disk I/O while the BBS is idle, you can increase this value. If you set this value below 1, the BBS server threads will use the default value (2). | ||
+ | |||
+ | **Note**: | ||
+ | The '' | ||
+ | |||
+ | === BindRetryCount === | ||
+ | |||
+ | Default: '' | ||
+ | |||
+ | Set the number of times an interface //bind// will be attempted for each port (before giving up and failing to start/ | ||
+ | |||
+ | Increase this value if you get errors binding to ports on reloads (especially on *nix). | ||
+ | |||
+ | **Note**: | ||
+ | This setting may be overridden by a '' | ||
+ | |||
+ | === BindRetryDelay === | ||
+ | |||
+ | Default: '' | ||
+ | |||
+ | Delay (in seconds) between bind retries. | ||
+ | |||
+ | **Note**: | ||
+ | This setting may be overridden by a '' | ||
+ | |||
+ | === LogLevel === | ||
+ | |||
+ | Default: '' | ||
+ | |||
+ | Highest log level to actually log/print (ignore all higher/ | ||
+ | Supported log levels in decreasing severity (ala [[: | ||
+ | Emergency, Alert, Critical, Error, Warning, Notice, Informational, | ||
+ | | ||
+ | **Note**: | ||
+ | This setting may be overridden by a '' | ||
+ | |||
+ | === JavaScript* === | ||
+ | |||
+ | See [[JavaScript]] for details. | ||
+ | |||
+ | **Note**: | ||
+ | Each '' | ||
+ | |||
+ | === LoginAttemptDelay === | ||
+ | Default: '' | ||
+ | |||
+ | The number of milliseconds to pause after a failed login attempt. | ||
+ | |||
+ | **Note**: | ||
+ | Each '' | ||
+ | |||
+ | === LoginAttemptThrottle === | ||
+ | Deafult: '' | ||
+ | |||
+ | This value is multiplied by the number of consecutive unique failed login attempts and the result is the number of milliseconds to delay a connection from a suspicious host (e.g. with multiple consecutive unique failed login attempts). | ||
+ | |||
+ | === LoginAttemptHackThreshold === | ||
+ | Default: '' | ||
+ | |||
+ | The number of consecutive unique failed login attempts from the same host before adding entries to the '' | ||
+ | |||
+ | Set to '' | ||
+ | |||
+ | === LoginAttemptTempBanThreshold === | ||
+ | Default: '' | ||
+ | |||
+ | The number of consecutive unique failed login attempts from the same host before temporarily banning connections from that client (based o IP address). | ||
+ | |||
+ | Set to '' | ||
+ | |||
+ | **Note**: Failed logins using any of the filtered user IDs (from '' | ||
+ | |||
+ | === LoginAttemptTempBanDuration === | ||
+ | Default: '' | ||
+ | |||
+ | The length (in seconds) of a temporary IP ban based on either multiple consecutive failed login attempts or any failed login attempt using a banned user ID (from '' | ||
+ | |||
+ | === LoginAttemptFilterThreshold === | ||
+ | Default: '' | ||
+ | |||
+ | The number of consecutive unique failed login attempts from the same host before auto-filtering the host's IP address in the '' | ||
+ | |||
+ | For this auto-filtering feature to work with the Synchronet v3.16c Terminal Server (Telnet, RLogin, and SSH login attempts), the sysop must set '' | ||
+ | |||
+ | Set to '' | ||
==== [BBS] ==== | ==== [BBS] ==== | ||
See [[: | See [[: | ||
+ | |||
+ | In addition to the keys listed in the '' | ||
+ | |||
+ | === AutoStart === | ||
+ | |||
+ | Default: '' | ||
+ | |||
+ | Automatically startup the [[server: | ||
+ | |||
+ | === TelnetInterface === | ||
+ | |||
+ | Default: value of '' | ||
+ | |||
+ | The IPv4 and/or IPv6 addresses of the network interfaces to listen on for incoming Telnet connections on ('' | ||
+ | |||
+ | === TelnetPort === | ||
+ | |||
+ | Default: '' | ||
+ | |||
+ | The TCP port number on which to listen for incoming Telnet connections. | ||
+ | |||
+ | === RLoginInterface === | ||
+ | |||
+ | Default: value of '' | ||
+ | |||
+ | The IPv4 and/or IPv6 addresses of the network interfaces to listen on for incoming RLogin connections on ('' | ||
+ | |||
+ | === RLoginPort === | ||
+ | |||
+ | Default: '' | ||
+ | |||
+ | The TCP port number on which to listen for incoming RLogin connections. | ||
+ | |||
+ | === SSHInterface === | ||
+ | |||
+ | Default: value of '' | ||
+ | |||
+ | The IPv4 and/or IPv6 address of the network interfaces to listen for incoming Secure Shell (SSH) connections on ('' | ||
+ | |||
+ | === SSHPort === | ||
+ | |||
+ | Default: '' | ||
+ | |||
+ | The TCP port number on which to listen for incoming Secure Shell (SSH) connections. | ||
+ | |||
+ | === SSHConnectTimeout === | ||
+ | |||
+ | Default: '' | ||
+ | |||
+ | The maximum amount of time allowed for a SecureShell (SSH) connection negotiation to complete. | ||
+ | |||
+ | === Pet40Port === | ||
+ | |||
+ | Default: '' | ||
+ | |||
+ | If a connection is made to the [[: | ||
+ | |||
+ | === Pet80Port === | ||
+ | |||
+ | Default: '' | ||
+ | |||
+ | If a connection is made to the [[: | ||
+ | |||
+ | === OutboundInterface === | ||
+ | |||
+ | Default: '' | ||
+ | |||
+ | The IPv4 address of the network interface to use for outgoing TCP/IP connections (i.e. for Telnet and RLogin gateway connections). | ||
+ | |||
+ | === FirstNode === | ||
+ | |||
+ | Default: '' | ||
+ | |||
+ | The number of the first terminal server node serviced by this instance of Synchronet. The minimum value for this settings is '' | ||
+ | |||
+ | Normally, this value should be left at '' | ||
+ | |||
+ | === LastNode === | ||
+ | |||
+ | Default: '' | ||
+ | |||
+ | The number of the last terminal server node serviced by this instance of Synchronet. The minimum value for this settings is '' | ||
+ | Specified last_node (x) > sys_nodes (y), auto-corrected | ||
+ | |||
+ | === MaxConcurrentConnections === | ||
+ | |||
+ | Default: '' | ||
+ | |||
+ | If set to a non-zero number, this will limit the number of concurrent connections to the [[server: | ||
+ | |||
+ | === OutbufHighwaterMark === | ||
+ | |||
+ | Default: '' | ||
+ | |||
+ | === OutbufDrainTimeout === | ||
+ | |||
+ | Default: '' | ||
+ | |||
+ | === SemFileCheckFrequency === | ||
+ | |||
+ | Default: value of '' | ||
+ | |||
+ | === TempDirectory === | ||
+ | |||
+ | Default: value of '' | ||
+ | |||
+ | === HostName === | ||
+ | |||
+ | Default: value of '' | ||
+ | |||
+ | === ExternalTermANSI === | ||
+ | |||
+ | Default: '' | ||
+ | |||
+ | When the BBS is running on a *nix-like OS, this value determines the value of the '' | ||
+ | |||
+ | === ExternalTermDumb === | ||
+ | |||
+ | Default: '' | ||
+ | |||
+ | When the BBS is running on a *nix-like OS, this value determines the value of the '' | ||
+ | |||
+ | === UseDOSemu === | ||
+ | |||
+ | Default: '' | ||
+ | |||
+ | This will enable [[howto: | ||
+ | |||
+ | === DOSemuPath === | ||
+ | |||
+ | Default: ''/ | ||
+ | |||
+ | When the BBS is running on a *nix-like OS, this value determines the default path of the DOS emulator to be executed when a non-native program (e.g. 16-bit MS-DOS door game) will be invoked by the BBS. | ||
+ | |||
+ | === DOSemuConfPath === | ||
+ | |||
+ | Default: '' | ||
+ | |||
+ | This specifies where DOSEmu should look for the conf file. If you only specify a filename, it will look in the '' | ||
+ | |||
+ | The order of using conf file locations is: | ||
+ | |||
+ | - It will look in the startup dir of the external program | ||
+ | - It will use this path from sbbs.ini (if configured) | ||
+ | - It use / | ||
+ | - It will use / | ||
+ | |||
+ | === AnswerSound === | ||
+ | |||
+ | Default: //none// | ||
+ | |||
+ | Path to a WAVE file to played (locally) when accepting incoming connections. Only supported on Windows. | ||
+ | |||
+ | === HangupSound === | ||
+ | |||
+ | Default: //none// | ||
+ | |||
+ | Path to a WAVE file to be played (locally) when terminating connections. Only supported on Windows. | ||
+ | |||
+ | === Options === | ||
+ | |||
+ | Default: '' | ||
+ | |||
+ | Recommended: | ||
+ | |||
+ | Supported options, separated by the pipe ('' | ||
+ | |||
+ | ^ Option | ||
+ | |XTRN_MINIMIZED | ||
+ | |AUTO_LOGON | Enable automatic login based on IP address for V-exempt users (not recommended) | | ||
+ | |DEBUG_TELNET | ||
+ | |ALLOW_SSH | Enable the Secure Shell (SSH) protocol for incoming connections | | ||
+ | |ALLOW_RLOGIN | Enable the RLogin protocol for incoming connections | | ||
+ | |NO_QWK_EVENTS | ||
+ | |NO_NEWDAY_EVENTS| Disable daily events from running in this instance of Synchronet | | ||
+ | |NO_EVENTS | Disable the Events thread (all timed events) | | ||
+ | |NO_TELNET_GA | ||
+ | |NO_HOST_LOOKUP | ||
+ | |NO_SPY_SOCKETS | ||
+ | |NO_DOS | ||
+ | |NO_RECYCLE | ||
+ | |GET_IDENT | Use the IDENT protocol on incoming connections | | ||
+ | |||
==== [FTP] ==== | ==== [FTP] ==== | ||
Line 42: | Line 394: | ||
==== [Services] ==== | ==== [Services] ==== | ||
+ | |||
+ | ^ Key ^ Default | ||
+ | | iniFileName | ||
+ | | Interfaces | ||
+ | | JavaScript* | ||
+ | | LoginAttempt* | // | ||
+ | | HostName | ||
+ | | TempDirectory | // | ||
+ | | SemFileCheckFrequency | //Global// | Frequency (interval) in seconds between semaphore file checks | | ||
+ | | AnswerSound | ||
+ | | HangupSound | ||
+ | | BindRetryCount | // | ||
+ | | BindRetryDelay | // | ||
+ | | LogLevel | ||
+ | | Options | ||
See [[: | See [[: | ||
Line 54: | Line 421: | ||
- | + | {{tag> | |
- | + | ||