gnt-os -- instance operating system administration


gnt-os {command} [arguments...]


The gnt-os is used for managing the list of available operating system flavours for the instances in the ganeti cluster.



Gives the list of available/supported OS to use in the instances. When creating the instance you can give the OS-name as an option.


This command will help you see why an installed OS is not available in the cluster. The list command shows only the OS-es that the cluster sees available on all nodes. It could be that some OS is missing from a node, or is only partially installed, and this command will show the details of all the OSes and the reasons they are or are not valid.

modify [-H HYPERVISOR [: option=value... ]] {OS}

This command will allow you to modify OS parameters. At the moment we just support per-os-hypervisor settings. You can run modify -H with the same syntax as in gnt-cluster init to override default hypervisor parameters of the cluster for specified OS argument.

Note: The OS doesn't have to exists. This allows preseeding the settings for OSes not yet known to gnt-os.


Report bugs to or contact the developers using the ganeti mailing list <>.


Ganeti overview and specifications: ganeti(7) (general overview), ganeti-os-interface(7) (guest OS definitions).

Ganeti commands: gnt-cluster(8) (cluster-wide commands), gnt-job(8) (job-related commands), gnt-node(8) (node-related commands), gnt-instance(8) (instance commands), gnt-os(8) (guest OS commands), gnt-backup(8) (instance import/export commands), gnt-debug(8) (debug commands).

Ganeti daemons: ganeti-watcher(8) (automatic instance restarter), ganeti-cleaner(8) (job queue cleaner), ganeti-noded(8) (node daemon), ganeti-masterd(8) (master daemon), ganeti-rapi(8) (remote API daemon).


Copyright (C) 2006, 2007, 2008, 2009 Google Inc. Permission is granted to copy, distribute and/or modify under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL.