.. _ref_cubic_snapshot:

cubic snapshot
==============

.. code-block::

    $ cubic snapshot --help
    Create a snapshot of a VM instance
    
    A snapshot saves the disk of a VM instance so it can be restored later with
    `cubic restore`. The VM instance has to be stopped first. Snapshots of the
    same instance share every block that did not change, so keeping several of
    them stays cheap.
    
    The settings of a VM instance, such as CPUs, memory and forwarded ports, are
    not part of a snapshot and are never rolled back.
    
    Examples:
    
      Snapshot the VM instance 'my-instance' as 'clean':
      $ cubic snapshot my-instance/clean
    
    Usage: cubic snapshot [OPTIONS] <INSTANCE/SNAPSHOT>
    
    Arguments:
      <INSTANCE/SNAPSHOT>
              Snapshot of a virtual machine instance, written as <INSTANCE>/<SNAPSHOT>
    
    Options:
      -v, --verbose
              Increase logging output
    
      -q, --quiet
              Reduce logging output
    
      -h, --help
              Print help (see a summary with '-h')