Synchronet BBS - Multinode Bulletin Board Software

Back to Table of Contents

[2.0] - System Configuration

SCFG is the Synchronet Configuration Utility. It is a stand-alone console mode 
application (e.g. SCFG.EXE for Windows).
To run SCFG from the Synchronet Control Panel (Windows), select Configure from the 
BBS sub-menu on the menu bar.
Once SCFG has initialized, you will see a main menu titled "Configure" which looks 
something like this:

To manipulate the light-bar, use the UP and DOWN ARROW keys or type a letter or
number in the option you wish to highlight. To highlight the first option of
the menu, hit the HOME key. To highlight the last option of the menu, hit the 
END key. You'll notice that if you hit UP ARROW key when the light-bar is at the 
first option of the menu, the last option will become highlighted. This wrap effect 
also occurs when hitting the DOWN ARROW key when the light-bar is at the last option 
of the menu. To select the current highlighted option, hit ENTER. To exit SCFG,
hit the ESC key.
Under "System", set your system's name (BBS Name), the sysop's name (You), the
system location (City, State), and system password. The system password you
enter here will be required for any remote sysop operations and is prompted
for with an "SY:" prompt. Under "Message Options", set your system's QWK ID
(Up to 8 character BBS name abbreviation). Under "Toggle Options" set
"Allow Aliases" to "Yes" or "No" depending on if you want users to be known
by their real names on your BBS or a personal alias.
Remember that at any time within SCFG, you can hit the F1 key to get online
help about the current configuration window. Following is a more specific list
of the commands available in the SCFG under System options.

[2.1] - Message Options

BBS ID for QWK Packets:
	This is the ID that will be used in QWK packets. It is important that
	you set this to an abbreviation of your BBS name before users start
	using the QWK functions of your BBS. Only valid DOS filename characters
	can be used and the ID must begin with an alphabetic character. This
	ID will also serve as your system's QWK Network address, should you
	choose to join a QWK message network (e.g. DOVE-Net).

Local Time Zone:
	This should be set to the time zone where your BBS is located.

Maximum Retry Time:
	This is the maximum number of seconds the Synchronet message base
	library will wait for a locked message base to become unlocked.
	Under normal conditions, message bases are only left locked for an
	extremely short period of time.

Maximum QWK Messages:
	This is the maximum number of messages which will be packed when a
	QWK packet is created. If the number of new messages to be packed
	exceeds this, the packing will be stopped after packing this number
	of messages. Setting this value to 0 sets the number of messages
	per packet to unlimited. Private e-mail is not included in the total
	number of messages and QWK network nodes are automatically exempt
	from this maximum.

Pre-pack QWK Requirements:
	If this option is used (not blank), Synchronet will pre-pack any new
	messages into a QWK packet in the DATA\FILE directory for each user
	that meets this requirement. When that user calls to download their
	packet, it will automatically extract the pre-packed QWK (if it
	exists) and append to it. It is mainly intended for QWKnet nodes that
	feed from your BBS, but can also be used for long distance users that
	wish to save connect time and always read their messages via QWK.

Purge E-mail by Age:
	This will allow electronic mail for your users (stored in DATA\MAIL.*)
	to be purged after a specific number of days (read or unread).

Purge Deleted E-mail:
	This option can be set to "Daily" or "Immediately". If set to
	"Immediately", e-mail marked for deletion will be physically removed
	from the e-mail database immediately after the user exits the
	reading mail menu. If set to "Daily" (the suggested setting), e-mail
	is marked for deletion isn't physically removed from the database
	until the automatic daily event executes (sometime after midnight).

Duplicate E-mail Checking:
	This option allows the setting of a number of message CRCs to be kept
	to check e-mail to insure that it is not a duplicate of another piece
	of e-mail. This option should be set to 0 (disabled) unless you
	specifically want duplicate e-mail disallowed, in which case a value
	of 2000 should be sufficient.

Allow Anonymous E-mail:
	Setting this option to Yes will allow users with the 'A' exemption to
	send anonymous e-mail.

Allow Quoting in E-mail:
	To allow users to quote from e-mail, this option should be set to Yes.

Allow Uploads in E-mail:
	To allow users to attach files to e-mail, this option must be set to

Allow Forwarding to NetMail:
	If you allow users to send NetMail on your BBS and want to allow your
	users to set their account to forwarding their e-mail to a NetMail
	address, set this option to Yes.

Kill Read E-mail:
	If you would like to have any e-mail that has been read by the
	recipient automatically deleted by the message base maintenance program
	(SMBUTIL) set this option to yes.

Users Can View Deleted Messages:
	This option allows all users or sysops/sub-ops the ability to view
	messages (posts/e-mail) marked for deletion (and optionally undelete
	them) before they are permanently removed from the message base.

Extra Attribute Codes...:
	This option will give you a sub-menu of toggle options. These options
	tell Synchronet whether or not it should interpret color codes which
	are supported by other BBS packages.

[2.2] - System Options

BBS Name:
        This is the name of the BBS. Try to be original. :-)

        This is the city, state and/or other pertinent location information.

        This is the name of the system operator. Doesn't have to be the same
        as user #1, but usually is.

        This is the super-secret system password that only sysops should know.

Users Can Change Password:
        If you want enhanced system security, it is suggested that you force
        users to keep the original randomly generated password they were
        assigned by setting this option to No. If you do allow users to change
        their passwords, you can make them change their password periodically
        with this selection.

Days to Preserve Deleted Users:
        If a user is deleted, his slot will be preserved for this many days
        since his last logon date. Preserved slots will not be written over
	by new users. Preserved slots may be undeleted by the sysop.

Maximum Days of Inactivity:
        If you wish that users that haven't logged on in a certain number of
        days be automatically deleted, set this value to the maximum number
        of days a user can be inactive before he is deleted. Users can be
        exempted from the automatic deletion with the 'P' exemption. Setting
        this value to 0 disables this feature (Unlimited inactivity).

New User Password:
        If this field has a value, new users will have to enter this password
        correctly before being able apply for access.

[2.3] - System Toggle Options

Selecting this option will bring you to the following sub-menu:
Allow Aliases:
        If you wish the users of the BBS to be allowed to use aliases publicly,
        set this option to Yes.

Allow Time Banking:
	Set this option to Yes to allow users to store their time in a time
	bank, or to convert their credits to time via the BBS.

Allow Credit Conversions:
	Setting this option to Yes will allow users to be able to convert
	credits to time.

Allow Sysop Logins:
	To be able to perform sysop actions remotely, this option should be set
	to Yes.

Echo Passwords Locally:
	If this option is set to No, all BBS passwords will not be displayed
	locally (characters will be replaced by an X). This includes passwords
	entered during logon, passwords in the user editor, as well as
	passwords normally displayed on the status line.

Short Sysop Page:
	If set to Yes, this sysop page will be a short series of beeps,
	otherwise a continuous sysop page will be used.

Sound Alarm on Error:
	If the above option (beep locally) is toggled off, but you still wish
	to have errors produce an audible alarm, you should toggle this option
	to Yes.

Include Sysop in Statistics:
        It is suggested that you set this option to No, so that the sysop's
        activity on the BBS is not included in the usage statistics.

Closed to New Users:
        If you wish to disallow access to any new users, set this option to

Use Location In User Lists:
        If you wish the location (City, State) of the user to be displayed
        in user listings instead of the user note, set this option to Yes.
        Setting this option to No will display the user's note (sysop created)
	if one has been created. The option should be set to Yes if using
	Caller-ID since the user's note may contain their phone number.

Military (24 hour) Time Format:
	Use this option to toggle your BBS between 12 and 24 hour time formats.

European Date Format (DD/MM/YY):
	This option should ONLY be toggle to Yes if you are in a European
	country which uses this date format. All countries using the MM/DD/YY
	format should leave this option set to No. If your BBS has been running
	for any length of time with this option set to No, you should NOT
	change it to Yes.

User Expires When Out-of-time:
	Useful for BBSs which charge users based on time, this option, when set
	to Yes, will set a user to the expired account values once the user's
	time runs out.
Display Sys Info During Logon:
	Display "hard-coded" system information during BBS logon process.
Display Node List During Logon:
	Display list of active BBS nodes during BBS logon process.

[2.4] - New User Values

This option allows you to modify the security values assigned to a new user
account. You can also set the number of credits and minutes new users start
off with. If you have configured an alternate command shell or external
editors, you may select one of these as the default for new users. See the
User Editor chapter for more information about user account values.
The 'Default Toggles' are used to set the account defaults that users will have
when they log on to the system as a new user. These account defaults can be
changed by the user at logon, or while on the system from the user defaults
The 'Question Toggles' are used to enable/disable the different questions which
new users will be asked when logging on to the BBS. The 'Force Unique...'
question toggles are used to force users to pick a string that is not being
used by any of the other users currently in the system user database.

[2.5] - Advanced Options

New User Magic Word:
        If this field has a value, it is assumed the sysop would have put
        some reference to this "magic word" in NEWUSER.MSG and the user
        will be prompted for this after he enters his own assigned password.
        If he doesn't enter it correctly, it is assumed he didn't read the
        text displayed to him and he is disconnected.

Data Directory:
        This is the path to the directory where all the data files for
	Synchronet will be stored. This value should not be changed unless

Logs Directory:
        This is the path to the directory where all the logs files for
        Synchronet will be stored. This value should not be changed unless

Exec Directory:
        This is the path to the directory where all the executable files for
        Synchronet are stored. This value should not be changed unless

Mods Directory:
        This is the path to the directory where sysop-modified modules
	(.bin and .js files) for Synchronet are stored. Normally, this
	directory will be empty. If a sysop wishes to modify a stock/standard
	module and protect the modified file from being over-written during
	subsequent Synchronet upgrades, the sysop should copy the file from
	the Exec directory to the Mods directory where it will take precedence
	over the file by the same name in the Exec directory. 

Input SIF Questionnaire:
        This is the name of a SIF file that resides the text directory that
        all users will be prompted to answer upon logging on the first time.
        See SIF for more information.

Output SIF Questionnaire:
        This is the name of the SIF file that is used by the sysop to view
        the users' answers to the input SIF questionnaire. If this value is
        left blank, the input SIF questionnaire is used. This output SIF
        questionable should be identical to the input SIF with the exception
        of the text content. See SIF for more information.

Credits Per Dollar:
        This is the monetary value of a credit (How many credits per dollar).
        This value should be a power of 2 (1, 2, 4, 8, 16, 32, 64, 128, etc.)
        since credits are usually converted by 100 kilobyte (102400) blocks.
        To make a dollar worth two megabytes of credits, set this value to
        2,097,152 (a megabyte is 1024*1024 or 1048576).

Minutes Per 100k Credits:
        This is the value of a minute of time online. Credits can be converted
	to minutes by the user if allowed by the command shell. Credits are
	only converted in 100k (102400) blocks. This field is the number of
	minutes to give the user in exchange for the 100k credit block.

Maximum Number of Minutes:
        This value is the maximum total number of minutes a user can have. If
        the user has this number of minutes or more, he will not be allowed
        to convert credits into minutes. A sysop can add minutes to a user's
        account regardless of this maximum. If this value is set to 0, the
        user will have no limit on the total number of minutes he can have.

Warning Days Till Expire:
	When a users account is about to expire, the BBS will begin sending
	expiration warning messages to the users notifying them this many days
	in advance.

Default Status Line (v2 Only):
	This is the number of the status line that will be displayed by default
	at the bottom of the screen while the user is online.

Last Displayable Node:
	This is the number of the last node that will be viewable by the users.
	Any nodes which exist above this number will be "invisible" nodes and
	cannot be seen by anyone.

Phone Number Format:
	This is the format used for phone numbers in your local calling 
	area. Use N for number positions, A for alphabetic, or ! for any 
	character. All other characters will be static in the phone number 
	format. An example for North American phone numbers is NNN-NNN-NNNN.

Sysop Chat Override:
	Any user meeting the criteria set here will be able to page the sysop
	regardless of the status of the sysop availability.
User Database Backups:
	Setting this option to anything but 0 will enable automatic daily 
	backups of the user database. This number determines how many backups
	to keep on disk (i.e. data/user/user.#.dat and data/user/name.#.dat). 

Mail Database Backups:
	Setting this option to anything but 0 will enable automatic daily 
	backups of the mail database. This number determines how many backups
	to keep on disk (i.e. data/mail.#.*). 

Control Key Pass-through:
	This value is a 32-bit hexadecimal number. Each set bit represents a 
	control key combination that will not be handled internally by 
	Synchronet or by a Global Hot Key Event. 

	To disable internal handling of the Ctrl-C key combination (for example)
	set this value to 8. The value is determined by taking 2 to the power of
	the ASCII value of the control character (Ctrl-A is 1, Ctrl-B is 2, 
	etc.). In the case of Ctrl-C, taking 2 to the power of 3 equals 8. 

	To pass-through multiple control key combinations, multiple bits must be
	set (or'd together) to create the necessary value, which may require the
	use of a hexadecimal calculator. 

	If unsure, leave this value set to 0, the default. 

[2.6] - Loadable Modules

The Loadable Modules options are used for loading JavaScript (.js) or
Baja (.bin) modules during various stages of the BBS operation. Selecting
one of the functions will prompt you for the base filename of the module
(excluding the file extension - .js or .bin) to be used when that event
occurs. JavaScript (.js) modules take precedence over Baja (.bin) modules.

Following is a brief description of when each of the Loadable Modules occur
during the BBS operation:

	This module is REQUIRED for remote and local logins.  Occurs when a
	user is connected, immediately after the Synchronet copyright notice is

Logon Event:
	Occurs immediately after Login (above).

Sync Event:
	This is a Synchronization Event and occurs each time the BBS performs
	a node synchronization (e.g. when node messages are received, node
	status is read, etc...basically continuously while a user is online).

Logoff Event:
	Occurs ONLY when a user does a slow logoff.  Does NOT occur when users
	hang up on the BBS or do a fast logoff.

Logout Event:
	This is an offline event that occurs after a user has disconnected from
	the BBS, either by logging off or hanging up.

New User Event:
	Occurs at the end of a new user procedure (e.g. after the user has
	logged on, left new user feedback, and anything else that is
	required of a new user).

Expired User:
	This is an offline event that occurs during Synchronet's internal daily
	event (after the first caller at the beginning of a new day).

[2.7] - Security Level Values

This option allows you to define the operating parameters of the Security Levels (0-99).
Selecting the desired security level will bring you to another menu similar to
the following:
Here you can modify the corresponding values for that particular security
level.	These values will be given to ALL users who have the selected security
level.	Many of these values may be overridden by giving certain users the
necessary exemptions (if required).  For example, the 'T' exemption will exempt
a user from any time limitations.

[2.8] - Expired Account Values

This sub-menu contains the account values for expired user accounts. When
a user account expires, the information contained here will be applied to
that user account.

[2.9] - Quick Validation Values

This is where you define the values of the quick-validation sets (0-9).
Selecting a level from this list will bring you to another menu similar to the

These are used to quickly set a user's Level, Flags, Restrictions and
Exemptions, as well as extend their expiration date and add credits to their
account.  A user can be quick-validated with the 'V' command from the 
Telnet/RLogin-based User Editor.

[2.10] - Creating User Accounts

Users may be created using one of the available user editors or by logging
on as "new" via Telnet or RLogin.

[2.10.1] - Creating a Sysop Account

The first user account created (via Telnet or RLogin) will automatically be
given Sysop-level access (e.g. Security level 90, all flags and all exemptions).
For this reason, the System Password is prompted for (with the SY: prompt)
during the first new user creation process.
The sysop account is traditionally the first user record in the database
(i.e. user #1). This user account should not have the alias of Sysop - use your
real name or a handle instead. Synchronet automatically treats the alias of
Sysop special and forwards any mail received for "Sysop" to user #1.

[2.10.2] - Creating a Guest Account

During the default Telnet/RLogin logon process, the sysop user account will
be prompted whether to create a "Guest" account or not (via the exec/makeguest.js
module). It is recommended that you answer "Yes" to create a Guest account.
This will allow anonymous FTP logins as well as "read only" access to your
other servers and services which encourage users to experience your BBS without
requiring them to create a user account first.
The sysop account's Security Flag 4G is used by the default logon module
(exec/logon.js) to determine whether or not to prompt the sysop to create the
Guest account.  If you answered "No" to the create Guest and "Ask again later?"
prompts, you can either run the makeguest.js module manually, or restore the 4G
security flag to the sysop account to be prompted during the next logon.

Back to Top

Copyright 2006 by Rob Swindell

Synchronet BBS Software
(Synchronet) Version 3 is comprised of several documentation,
library, executable, and source code files, all of which are covered by the
GNU General Public License
with the exception of the following portions covered by
the GNU Lesser General Public License: SMBLIB and XSDK.

Synchronet Version 2 (for DOS and OS/2) and its source code was released to the
Public Domain
by Digital Dynamics in 1997 and remains Public Domain software today.
Synchronet Version 3 is not Public Domain software.

For the complete Copyright Information please read the Copyright Document .