raspi-config(8)
Interactive configuration tool for Raspberry Pi system settings.
Synopsis
raspi-config [--help] [--version] [nonint]Description
raspi-config is the official Raspberry Pi configuration utility that provides an interactive menu-driven interface for system setup and customization. It allows users to configure hardware settings, enable/disable interfaces, expand the filesystem, set passwords, configure locale and timezone, and manage performance settings without manual file editing.
When run without arguments, it launches an interactive ncurses menu. The nonint option enables non-interactive mode for scripting and automation, allowing configuration changes to be applied programmatically via command-line flags.
Common options
| Flag | What it does |
|---|---|
--help | Display help message and available options |
--version | Show version information |
nonint | Run in non-interactive mode for scripted automation |
do_expand_rootfs | Expand filesystem to fill SD card (nonint mode) |
do_change_pass | Change pi user password (nonint mode) |
do_configure_keyboard | Set keyboard layout and model (nonint mode) |
do_change_locale | Set system locale (nonint mode) |
do_change_timezone | Set timezone (nonint mode) |
do_wifi_ssid_passphrase | Configure WiFi SSID and password (nonint mode) |
do_ssh | Enable or disable SSH server (nonint mode) |
do_spi | Enable or disable SPI interface (nonint mode) |
do_i2c | Enable or disable I2C interface (nonint mode) |
Examples
Launch interactive configuration menu with all options
sudo raspi-configExpand filesystem to use full SD card capacity without user interaction
sudo raspi-config nonint do_expand_rootfsSet timezone to Eastern Time non-interactively
sudo raspi-config nonint do_change_timezone America/New_YorkConfigure system locale to US English UTF-8
sudo raspi-config nonint do_change_locale en_US.UTF-8Disable SSH server (0=disable, 1=enable)
sudo raspi-config nonint do_ssh 0Enable SPI interface for hardware communication
sudo raspi-config nonint do_spi 1Configure WiFi connection with SSID and password
sudo raspi-config nonint do_wifi_ssid_passphrase MyNetwork MyPasswordDisplay the version of raspi-config installed
sudo raspi-config --version