Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

Chapter 14. nova-manage command-line client

The nova-manage client is the command-line interface (CLI) for Compute service management utility.

This chapter documents nova-manage version 13.0.0.

For help on a specific nova-manage command, enter: 

$ nova-manage COMMAND --help
Copy to Clipboard Toggle word wrap

14.1. nova-manage usage
Copy link

usage: nova-manage [-h] [--remote_debug-host REMOTE_DEBUG_HOST]
                   [--remote_debug-port REMOTE_DEBUG_PORT] [--config-dir DIR]
                   [--config-file PATH] [--debug] [--log-config-append PATH]
                   [--log-date-format DATE_FORMAT] [--log-dir LOG_DIR]
                   [--log-file PATH] [--nodebug] [--nouse-syslog]
                   [--noverbose] [--nowatch-log-file]
                   [--syslog-log-facility SYSLOG_LOG_FACILITY] [--use-syslog]
                   [--verbose] [--version] [--watch-log-file]
                   {version,bash-completion,project,account,shell,logs,
                   service,cell_v2,db,vm,agent,cell,network,host,floating,
                   fixed,vpn,api_db}
                   ...
Copy to Clipboard Toggle word wrap

14.2. nova-manage optional arguments
Copy link

-h, --help
show this help message and exit
--config-dir DIR
Path to a config directory to pull *.conf files from. This file set is sorted, so as to provide a predictable parse order if individual options are over-ridden. The set is parsed after the file(s) specified via previous --config-file, arguments hence over-ridden options in the directory take precedence.
--config-file PATH
Path to a config file to use. Multiple config files can be specified, with values in later files taking precedence. Defaults to None.
--debug, -d
If set to true, the logging level will be set to DEBUG instead of the default INFO level.
--log-config-append PATH, --log_config PATH
The name of a logging configuration file. This file is appended to any existing logging configuration files. For details about logging configuration files, see the Python logging module documentation. Note that when logging configuration files are used then all logging configuration is set in the configuration file and other logging configuration options are ignored (for example, logging_context_format_string).
--log-date-format DATE_FORMAT
Defines the format string for %(asctime)s in log records. Default: None . This option is ignored if log_config_append is set.
--log-dir LOG_DIR, --logdir LOG_DIR
(Optional) The base directory used for relative log_file paths. This option is ignored if log_config_append is set.
--log-file PATH, --logfile PATH
(Optional) Name of log file to send logging output to. If no default is set, logging will go to stderr as defined by use_stderr. This option is ignored if log_config_append is set.
--nodebug
The inverse of --debug
--nouse-syslog
The inverse of --use-syslog
--noverbose
The inverse of --verbose
--nowatch-log-file
The inverse of --watch-log-file
--syslog-log-facility SYSLOG_LOG_FACILITY
Syslog facility to receive log lines. This option is ignored if log_config_append is set.
--use-syslog
Use syslog for logging. Existing syslog format is DEPRECATED and will be changed later to honor RFC5424. This option is ignored if log_config_append is set.
--verbose, -v
If set to false, the logging level will be set to WARNING instead of the default INFO level.
--version
show program’s version number and exit
--watch-log-file
Uses logging handler designed to watch file system. When log file is moved or removed this handler will open a new log file with specified path instantaneously. It makes sense only if log_file option is specified and Linux platform is used. This option is ignored if log_config_append is set.

14.2.1. nova-manage account
Copy link

usage: nova-manage account [-h] {quota,scrub} ...
Copy to Clipboard Toggle word wrap

Positional arguments:

{quota,scrub}

Optional arguments:

-h, --help
show this help message and exit

14.2.2. nova-manage agent
Copy link

usage: nova-manage agent [-h] {create,delete,list,modify} ...
Copy to Clipboard Toggle word wrap

Positional arguments:

{create,delete,list,modify}

Optional arguments:

-h, --help
show this help message and exit

14.2.3. nova-manage api_db
Copy link

usage: nova-manage api_db [-h] {sync,version} ...
Copy to Clipboard Toggle word wrap

Positional arguments:

{sync,version}

Optional arguments:

-h, --help
show this help message and exit

14.2.4. nova-manage cell
Copy link

usage: nova-manage cell [-h] {create,delete,list} ...
Copy to Clipboard Toggle word wrap

Positional arguments:

{create,delete,list}

Optional arguments:

-h, --help
show this help message and exit

14.2.5. nova-manage cell_v2
Copy link

usage: nova-manage cell_v2 [-h] {map_cell_and_hosts,map_instances} ...
Copy to Clipboard Toggle word wrap

Positional arguments:

{map_cell_and_hosts,map_instances}

Optional arguments:

-h, --help
show this help message and exit

14.2.6. nova-manage db
Copy link

usage: nova-manage db [-h]
                      {archive_deleted_rows,null_instance_uuid_scan,online_data_migrations,sync,version}
                      ...
Copy to Clipboard Toggle word wrap

Positional arguments:

{archive_deleted_rows,null_instance_uuid_scan,online_data_migrations,sync,version}

Optional arguments:

-h, --help
show this help message and exit

14.2.7. nova-manage fixed
Copy link

usage: nova-manage fixed [-h] {list,reserve,unreserve} ...
Copy to Clipboard Toggle word wrap

Positional arguments:

{list,reserve,unreserve}

Optional arguments:

-h, --help
show this help message and exit

14.2.8. nova-manage floating
Copy link

usage: nova-manage floating [-h] {address_to_hosts,create,delete,list} ...
Copy to Clipboard Toggle word wrap

Positional arguments:

{address_to_hosts,create,delete,list}

Optional arguments:

-h, --help
show this help message and exit

14.2.9. nova-manage host
Copy link

usage: nova-manage host [-h] {list} ...
Copy to Clipboard Toggle word wrap

Positional arguments:

{list}

Optional arguments:

-h, --help
show this help message and exit

14.2.10. nova-manage logs
Copy link

usage: nova-manage logs [-h] {errors,syslog} ...
Copy to Clipboard Toggle word wrap

Positional arguments:

{errors,syslog}

Optional arguments:

-h, --help
show this help message and exit

14.2.11. nova-manage network
Copy link

usage: nova-manage network [-h] {create,delete,list,modify} ...
Copy to Clipboard Toggle word wrap

Positional arguments:

{create,delete,list,modify}

Optional arguments:

-h, --help
show this help message and exit

14.2.12. nova-manage project
Copy link

usage: nova-manage project [-h] {quota,scrub} ...
Copy to Clipboard Toggle word wrap

Positional arguments:

{quota,scrub}

Optional arguments:

-h, --help
show this help message and exit

14.2.13. nova-manage shell
Copy link

usage: nova-manage shell [-h] {bpython,ipython,python,run,script} ...
Copy to Clipboard Toggle word wrap

Positional arguments:

{bpython,ipython,python,run,script}

Optional arguments:

-h, --help
show this help message and exit

14.2.14. nova-manage vm
Copy link

usage: nova-manage vm [-h] {list} ...
Copy to Clipboard Toggle word wrap

Positional arguments:

{list}

Optional arguments:

-h, --help
show this help message and exit

14.2.15. nova-manage vpn
Copy link

usage: nova-manage vpn [-h] {change} ...
Copy to Clipboard Toggle word wrap

Positional arguments:

{change}

Optional arguments:

-h, --help
show this help message and exit
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat