Synchronet v3.17b-Win32 (install) has been released (Jan-2019).

New Synchronet YouTube channel

You can donate to the Synchronet project using PayPal.

This is an old revision of the document!


The Synchronet BBS (SBBS) Initialization File is the mother of all Synchronet configuration files and is located in the ctrl directory.


The base filename of the initialization file is ctrl/sbbs.ini.

The standard host/platform variations of the initialization filenames are also supported. See INI Filenaming for details.


Download or view the default sbbs.ini file here: sbbs.ini


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->Properties menu or the various server configuration dialogs. Windows sysops may never need to edit this file by hand.

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.


The contents of the file are divided into multiple named sections:


The [Global] section contains keys whose values will serve as default values for like-named keys in other server sections in the sbbs.ini file.

These keys are:


Default: <none>

The public Internet hostname of this server.

If not set, the hostname configured in SCFG->Networks->Internet E-mail Address will be used.


Default: <any>

The IP address of the network interface to listen for incoming TCP/IP connections on.

If not set, any and all network interfaces available will be listened on.


Default: $SBBSCTRL

Specify the location of the Synchronet ctrl directory. Since this file is normally found in the ctrl directory (e.g. by way of the SBBSCTRL environment variable) you do not normally need to set this.


Default: ctrl/../temp

Override the default system “temp” directory (optional). If you do override this, do NOT use the system-wide temp dir (e.g.: /tmp or windows\temp), use a subdirectory instead. Synchronet assumes it is the only user of this directory/subdirectory for its temporary files only.


Default: 2 (seconds)

The interval, in seconds, betweeen semaphore file checks. If you want to reduce the amount of disk I/O while the BBS is idle, you can increase this value.


Default: 2

Set the number of times an interface bind will be attempted for each port (before giving up and failing to start/restart the server). An interface/port bind is required for listening for incoming TCP/IP connections.

Increase this value if you get errors binding to ports on reloads (especially on *nix).


Default: 15 (seconds)

Delay (in seconds) between bind retries.


Default: Debugging

Highest log level to actually log/print (ignore all higher/less-severe log entries). Supported log levels in decreasing severity (ala syslog):

Emergency, Alert, Critical, Error, Warning, Notice, Informational, Debugging


Default: 8M

Maximum allocation of memory per JavaScript run-time.


Default: 16K

Maximum stack size per JavaScript context.


Default: 864000 (24 hours)

Maximum number of ticks (100ms) before auto-termination of a JavaScript script (i.e. infinite loop detection).

Set to 0 for unlimited time (disables infinite loop detection).

Note: This key replaces the old JavaScriptBranchLimit key which is no longer used (as of Synchronet v3.16).


Default: 100

JavaScript Garbage Collection interval (in ticks).

Set to 0 for never.


Default: 10000

Time-slice yield interval (in ticks).

Set to 0 for never.


Default: load

Comma-separated list of load paths (relative to exec or mods directories).

These are the directories/sub-directories where the JavaScript load() method will search for filenames to be loaded by other scripts.


Default: 5000 (milliseconds)

The number of milliseconds to pause after a failed login attempt.


Deafult: 1000 (milliseconds)

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


Default: 10 (attempts)

The number of consecutive unique failed login attempts from the same host before adding entries to the hack.log file.

Set to 0 to disable automatic hack.log file entries for failed login attempts.


Default: 0 (attempts)

The number of consecutive unique failed login attempts from the same host before auto-filtering the host's IP address in the ip.can file.

Set to 0 to disable automatic filtering of IP addresses due to failed login attempts.


See Terminal Server for more details.


See FTP Server for more details.


See Mail Server for more details.


See Web Server for more details.


See Services and services.ini for more details.


See Configuring UNIX for more details.

See Also

In Other Languages
Translations of this page: