NVME-CONFIG-CONVER(1)             NVMe Manual            NVME-CONFIG-CONVER(1)

NAME
       nvme-config-convert - Convert a legacy NVMe-oF configuration to the INI
       format

SYNOPSIS
       nvme [<global-options>] config convert
                               [--config=<file> | -J <file>]
                               [--output=<file> | -o <file>]
                               [--force]
                               [--verbose | -v]

DESCRIPTION
       Converts a pre-3.0 NVMe-oF configuration from the legacy config.json
       JSON store and/or the discovery.conf argv-style file to the INI
       configuration format used by nvme connect-all and nvme discover. The
       INI format is documented at
       https://github.com/linux-nvme/nvme-cli/blob/master/libnvme/design/CONFIG.md

       By default, the command looks for the legacy files
       /etc/nvme/config.json and /etc/nvme/discovery.conf and converts any
       that exist into a single configuration, matching the behavior of nvme
       connect-all. Use --config to convert a config.json at a non-default
       path instead; as with nvme connect-all, discovery.conf conversion is
       not gated by --config -- /etc/nvme/discovery.conf is always converted
       when it exists, whether or not --config is given.

       The converted configuration is written to the file specified by
       --output. If --output is not specified, the default location,
       /etc/nvme/nvme-fabrics.conf, is used. Unless --force is specified, the
       command refuses to overwrite an existing configuration. On success, the
       converted legacy file(s) are renamed to <name>.converted to prevent
       conversion on subsequent runs. Running the command again is safe: a
       source file that is missing only because a prior run already converted
       and renamed it is treated as already done, not as an error.

       Malformed entries (for example, invalid addressing or an unreadable
       port) are skipped with a log message. Conversion continues unless a
       memory allocation failure occurs.

OPTIONS
       -J <file>, --config=<file>
           Convert this JSON file instead of the default
           /etc/nvme/config.json.

       -o <file>, --output=<file>
           Write the converted configuration here instead of the default
           /etc/nvme/nvme-fabrics.conf.

       --force
           Overwrite an existing configuration at the target. Any manual
           changes are lost.

       -v, --verbose
           Increase the level of detail in the output.

EXAMPLES
       o   Convert the system's legacy configuration in place:

               # nvme config convert

       o   Convert one specific configuration file for testing, without
           touching the system configuration:

               # nvme config convert --config /tmp/config.json --output /tmp/nvme-fabrics.conf

           Note: unlike config.json, discovery.conf has no --config-style
           override -- its path is always /etc/nvme/discovery.conf. If that
           file exists on the system, this command still converts it and
           renames it to discovery.conf.converted, even though --config points
           elsewhere.

SEE ALSO
       nvme-config-validate(1) nvme-config-show(1) nvme-config-status(1)
       nvme-connect-all(1) nvme-discover(1)
       https://github.com/linux-nvme/nvme-cli/blob/master/libnvme/design/CONFIG.md

NVME
       Part of the nvme-user suite

NVMe                              09/07/2026             NVME-CONFIG-CONVER(1)