Skip to content

Reload configuration

Reload configuration reads config.toml again while nuvem runs, so most changes apply without a restart. This page lists what a reload applies and what still needs a restart.

  1. Edit config.toml and save it.
  2. Press : and run Reload configuration (aliases reload config, config reload).
  3. Read the status line. It says configuration reloaded, or quotes the one warning, or counts the problems and names the key that opens the list.

Reload reads the config file again. It never changes cloud state and never fetches a list again.

Setting Applied by reload
general.theme yes
[theme.overrides], [theme.project_overrides] yes
general.sidebar_visible yes
general.poll_interval_secs yes
general.read_only only to turn read-only on; reload never turns it off
[aliases] yes
[hotkeys] yes
[favorites] yes
[columns.<service>] yes; see Columns and sort
[[jumps]] yes; see Jump rules
general.default_service no: restart required
the starting configuration (--configuration) no: restart required
plugins.toml no: restart required

When a setting that needs a restart has changed, the status line ends with restart required for: and names it, for example restart required for: plugins.

Reload applies the command-line flags nuvem started with again, so a flag still wins over the file.

If the file cannot be read or parsed, or declares an unknown version, reload leaves the running configuration untouched and shows the error in the status line. A problem inside one table drops only what that table’s rules drop. See Config problems.

nuvem is released under the MIT License. The source is on GitHub.

nuvem is an independent project, not affiliated with or endorsed by Google. Google Cloud is a trademark of Google LLC.