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


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


-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=<fname>   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
-host=<name>      set hostname to use for alternate sbbs.ini file
-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
-A                use alternate (ASCII) characters for arrow symbols
-v#               set video mode to # (default=auto)
-l#               set screen lines to # (default=auto-detect)
-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.



At any time within SCFG, you can press the F1 or ? keys or click the ? on a window to get online help about the list of options or items being viewed or the option being edited.

Key(s) Action
Up and Down arrows Move the lightbar that highlights the desired item
Page Up and Page Down Move the lightbar up or down one “screen full” at a time
Home Highlight first option in the menu
End Highlight the last option in the menu
Enter Select the highlighted item
Esc or Backspace Return to the previous menu, or if at the top-level menu, quit the SCFG application
F1 or ? Display help text on current windows/dialog/list
Ctrl-F Find an option or item in a list
Ctrl-G Find next option or item in list (after use of Ctrl-F)
Letters/numbers Pressing the first letter or number of an item in the menu will highlight that item

Editing keys:

Key(s) Action
Insert or + Insert new items in lists
Delete or - Delete items from lists
Ctrl-C or F5 or Ctrl-Insert Copy item from list into clipboard
Ctrl-X or Shift-Delete Cut item from list into clipboard
Ctrl-V or F6 or Shift-Insert Paste clipboard item into list (above highlighted item)

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.


See Also

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