.. _ref_cubic_exec:

cubic exec
==========

.. code-block::

    $ cubic exec --help
    Execute a command in a VM instance
    
    The words of the command are joined with a space and run by the shell of the
    VM instance, so all three forms below send the same command. Options of
    Cubic itself have to come before the command.
    
    Examples:
    
      Run a command in a VM instance:
      $ cubic exec noble -- echo -ne hello
      $ cubic exec noble echo -ne hello
      $ cubic exec noble "echo -ne hello"
    
      Quote the command to use the operators of the shell:
      $ cubic exec noble "sudo apt update && sudo apt full-upgrade -y"
    
    Usage: cubic exec [OPTIONS] <TARGET> <CMD>...
    
    Arguments:
      <TARGET>
              Target instance (format: [username@]instance, e.g. 'myinstance' or 'cubic@myinstance')
    
      <CMD>...
              Command to execute in the virtual machine instance
    
    Options:
          --accel <accel>
              Set hardware acceleration
              
              [default: auto]
              [possible values: auto, on, off]
    
          --env <KEY[=VALUE]>
              Environment variables to pass to the guest (KEY=VALUE or KEY to forward from host)
    
      -v, --verbose
              Increase logging output
    
      -q, --quiet
              Reduce logging output
    
      -h, --help
              Print help (see a summary with '-h')