Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
BSDCONFIG(8)		     System Manager's Manual		    BSDCONFIG(8)

NAME
     bsdconfig -- system configuration utility

SYNOPSIS
     bsdconfig [-h]
     bsdconfig command [-h]
     bsdconfig [OPTIONS] [command [OPTIONS]]

DESCRIPTION
     bsdconfig	is  used  to set up many system configuration settings, both for
     new systems, as well as changing configuration settings  of  existing  sys-
     tems.

     bsdconfig	optionally  takes  a command as an argument.  If invoked with no
     arguments, it will bring up an interactive menu listing the available  mod-
     ules.

     The following options are available:

     -d       Provide lots of debugging info on standard-out when running.

     -D file  Send  debugging info to file.  If file begins with a plus-sign de-
	      bug info is sent to both standard-out and file (minus the  leading
	      plus).

     -f file  Load  file as script and then exit.  If multiple occurrences, pro-
	      gram will only exit after last occurrence.  If file  is  a  single
	      dash (`-'), bsdconfig reads from standard input.

     -h       Print usage statement and exit.

     -S       Secure X11 mode (implies -X).  As root, always prompt-for and val-
	      idate sudo(8)(ports/security/sudo) username/password before start-
	      ing.

     -X       Use Xdialog(1)(ports/x11/xdialog) in place of dialog(1).

COMMANDS
     The  following  commands  (sorted alphabetically) are currently included in
     the base bsdconfig program, with more to be added soon.  Other commands can
     be added, as detailed below in the ADDING COMMANDS section, and once added,
     will appear in the master menu as well as in the -h listing.

     console		Utilities to customize the behavior of the  system  con-
			sole.

     defaultrouter	Shortcut  to  the Default Router/Gateway menu under net-
			working.

     diskmgmt		Manage disk partitions and/or labels.  Executes sade(8).

     docsinstall	Executes the bsdinstall docsinstall sub-utility to allow
			installation/re-installation of the  FreeBSD  Documenta-
			tion set(s).

     dot		Generate a graphviz dot(1)(ports/graphics/graphviz) lan-
			guage file (printed on stdout) visualizing the bsdconfig
			menu,  include,  and  shortcut	structure relationships.
			See "bsdconfig dot -h" for more details.

     groupadd		Shortcut to the Add Groups menu under groupmgmt.

     groupdel		Shortcut to the Delete Groups menu under groupmgmt.

     groupedit		Shortcut to the Edit/View Groups menu under groupmgmt.

     groupmgmt		Utilities to Add/Change/View/Delete Group Accounts.

     hostname		Shortcut to the Hostname/Domain menu under networking.

     kern_securelevel	Shortcut to the kern.securelevel menu under security.

     mouse		Utilities for configuring, exploring, and enabling  con-
			sole mouse support.

     mouse_disable	Shortcut to the Disable menu under mouse.

     mouse_enable	Shortcut to the Enable menu under mouse.

     mouse_flags	Shortcut to the Flags menu under mouse.

     mouse_port 	Shortcut to the Port menu under mouse.

     mouse_type 	Shortcut to the Type menu under mouse.

     nameservers	Shortcut to the DNS Nameservers menu under networking.

     netdev		Shortcut  to  the Network Interfaces menu under network-
			ing.

     networking 	Utilities to set/change Hostname/Domain, Network  Inter-
			faces, Wireless Network, Default Router/Gateway, and DNS
			Nameservers.

     packages		Browse, install, uninstall, or re-install packaged soft-
			ware.

     password		Set the system administrator (root) password.

     security		Configure various system security settings.

     startup		Configure various aspects of system startup.

     startup_misc	Shortcut  to the Miscellaneous Startup Services menu un-
			der startup.

     startup_rcadd	Shortcut to the Add New menu under the View/Edit Startup
			Configuration menu (startup_rcconf) of startup.

     startup_rcconf	Shortcut to the View/Edit Startup Configuration menu un-
			der startup.

     startup_rcdelete	Shortcut to the Delete menu under the View/Edit  Startup
			Configuration menu (startup_rcconf) of startup.

     startup_rcvar	Shortcut  to  the  Toggle  Startup  Services  menu under
			startup.

     syscons_font	Shortcut to the Font menu under console for syscons(4).

     syscons_keymap	Shortcut  to  the  Keymap   menu   under   console   for
			syscons(4).

     syscons_repeat	Shortcut   to	the   Repeat   menu  under  console  for
			syscons(4).

     syscons_saver	Shortcut to the Saver menu under console for syscons(4).

     syscons_screenmap	Shortcut  to  the  Screenmap  menu  under  console   for
			syscons(4).

     syscons_ttys	Shortcut to the Ttys menu under console for syscons(4).

     vt_font		Shortcut to the Font menu under console for vt(4).

     vt_keymap		Shortcut to the Keymap menu under console for vt(4).

     vt_repeat		Shortcut to the Repeat menu under console for vt(4).

     vt_saver		Shortcut to the Saver menu under console for vt(4).

     vt_screenmap	Shortcut to the Screenmap menu under console for vt(4).

     vt_ttys		Shortcut to the Ttys menu under console for vt(4).

     timezone		Set the regional timezone of the local machine.

     ttys		Edit the ttys(5) database with your favorite editor.

     useradd		Shortcut to the Add Users menu under usermgmt.

     userdel		Shortcut to the Delete Users menu under usermgmt.

     useredit		Shortcut to the Edit/View Users menu under usermgmt.

     usermgmt		Utilities to Add/Edit/View/Delete User Accounts.

     wireless		Shortcut to the Wireless Networks menu under networking.

INTERNATIONALIZATION
     i18n  features  are  built into bsdconfig and language-specific translation
     files will be added as they become available.  In the absence of  language-
     specific  translation  files,  the  default (en_US.ISO8859-1) files will be
     used.

ADDING COMMANDS
     To be documented later.  Document menu_selection="command|*" syntax of  IN-
     DEX files.

ENVIRONMENT VARIABLES
     The following environment variables affect the execution of bsdconfig:

     LANG    If  LANG  is  set, messages and index information will be read from
	     files named messages.$LANG and INDEX.$LANG and fall back  to  files
	     named  messages  and INDEX if messages.$LANG and INDEX.$LANG do not
	     exist.  LANG takes precedence over LC_ALL.

     LC_ALL  If LC_ALL is set, messages and index information will be read  from
	     files  named  messages.$LC_ALL  and  INDEX.$LC_ALL and fall back to
	     files  named  messages  and  INDEX  if  messages.$LC_ALL  and   IN-
	     DEX.$LC_ALL do not exist.

FILES
     /usr/share/examples/bsdconfig/bsdconfigrc can be copied to $HOME/.bsdconfi-
     grc and customized as needed.

EXIT STATUS
     The bsdconfig utility exits 0 on success, and >0 if an error occurs.

SEE ALSO
     bsdinstall(8)

HISTORY
     bsdconfig first appeared in FreeBSD 9.2.

AUTHORS
     Ron McDowell
     Devin Teske <dteske@FreeBSD.org>

BUGS
     The  docsinstall and diskmgmt modules call bsdinstall.  Bugs found in these
     modules should be considered those of bsdinstall, not bsdconfig.

FreeBSD 16.0 CURRENT		  June 9, 2026			    BSDCONFIG(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=bsdconfig&sektion=8&manpath=FreeBSD+16.0-CURRENT>

home | help