The Synchronet Configuration Utility (SCFG) is used for viewing and modifying the primary ini files in the Synchronet ctrl directory.

SCFG Main Menu


SCFG may be invoked from the Synchronet Control Panel with the BBS->Configure menu option:

Or by running scfg from a command prompt.

:!: Note: If the Synchronet exec directory is not in your search path, you may need to change the current working directory (e.g. using cd) or specify the full path to scfg.


SCFG is a native executable program.

On Windows, the executable file is: exec/scfg.exe

On UNIX, the executable file is: exec/scfg

Command-line Usage

Help on the command-line usage can be displayed by executing the command: scfg -? or scfg –help:

usage: scfg [ctrl_dir] [options]


-w  =  run initial setup wizard
-f  =  force save of configuration files
-a  =  update all message base status headers
-h  =  don't update message base status headers
-u# =  set file creation permissions mask (in octal)
-k  =  keyboard mode only (no mouse support)
-c  =  force color mode
-m  =  force monochrome mode
-e# =  set escape delay to #msec
-insert = enable keyboard insert mode by default
-import=<filename> = import a message area list file
-faddr=<addr> = specify your FTN address for imported subs
-misc=<value> = specify option flags for imported subs
-g# =  set group number (or name) to import into
-iX =  set interface mode to X (default=auto) where X is one of:
       X = X11 mode
       C = Curses mode
       F = Curses mode with forced IBM charset
       I = Curses mode with forced ASCII charset
       A = ANSI mode
       D = standard input/output/door mode
-v# =  set video mode to # (default=auto)
-l# =  set screen lines to # (default=auto-detect)
-b# =  set automatic back-up level (default=5)
-y  =  automatically save changes (don't ask)

:!: Note: some of the interface mode values are only available on particular platforms/operating systems.

CTRL Directory

If the SBBSCTRL environment variable is set, then SCFG will find the ini files without needing you to specify the path to the ctrl directory ([ctrl_dir]) on the command-line.

If the SBBSCTRL environment variable is not set and the [ctrl_dir] is not specified on the command-line, SCFG will look for the ini files in the current working directory.

Usage and Help

At any time within SCFG, you can press the F1 key or click the ? on a window to get online help about the section being edited.

  • Up and Down arrows: Move the lightbar that highlights the desired item.
  • Home: highlight first option in the menu.
  • End: highlight the last option in the menu.
  • Enter: select the highlighted item.
  • Esc return to the previous menu, or if at the top-level menu, quit the SCFG application.
  • Pressing the first letter or number of an item in the menu will highlight that item.

Using SCFG

Initial Setup Wizard

When SCFG detects a new installation, or is invoked with the -w command-line options, it'll start the Initial Setup Wizard which will prompt for various import initial configuration settings.

Standard I/O Mode


Full-screen Mode


Graphics vs. Text Mode


See Also

util/scfg.txt · Last modified: 2023/02/12 15:17 by digital man
Back to top
CC Attribution 4.0 International
Driven by DokuWiki Recent changes RSS feed Valid CSS Valid XHTML 1.0