Configuring Settings

ZVM has additional settings stored in ~/.zvm/settings.json. You can manually update version maps, toggle color support, and control install behavior here. Many settings also have command flags or environment variables. This file is stateful, and ZVM creates it if it does not exist.

Environment Variables

• ZVM_DEBUG enables DEBUG logging for your executable. This is meant for contributors and developers.
• ZVM_SET_CU Toggle the automatic upgrade checker. If you want to reenable the checker, just unset ZVM_SET_CU.
• ZVM_PATH replaces the default install location for ZVM. Set the environment variable to the parent directory of where you’ve placed the .zvm directory.
• ZVM_SKIP_TLS_VERIFY Do you have problems using TLS in your environment? Toggle off verifying TLS by setting this environment variable.
  • By default when this is enabled ZVM will print a warning. Set this variable to no-warn to silence this warning.
• ZVM_TARGET_OS overrides the OS ZVM downloads binaries for. Equivalent to the --target-os flag. Case-insensitive; accepts Go-style (linux, darwin) or Zig-style (linux, macos) names. See Cross-target installs.
• ZVM_TARGET_ARCH overrides the CPU architecture ZVM downloads binaries for. Equivalent to --target-arch. Case-insensitive; accepts amd64 / x86_64 and arm64 / aarch64.
• ZVM_HTTP_TIMEOUT sets the HTTP timeout in seconds. Equivalent to the --http.timeout install flag.
• BROWSER selects the command used by zvm bug to open a report URL.

Option Flags

Color Toggle

Enable or disable colored ZVM output. No value toggles colors.

Enable

• on
• yes/y
• enabled
• true

Disabled

• off
• no/n
• disabled
• false

--color # Toggle ANSI color printing on or off for ZVM's output, i.e. --color=true