.. _ref_cubic_restore:

cubic restore
=============

.. code-block::

    $ cubic restore --help
    Restore a VM instance from a snapshot
    
    This rolls the disk of the VM instance back to the state it had when the
    snapshot was taken, including its size. Everything written since then is
    lost. A running VM instance is stopped first.
    
    The settings of a VM instance, such as CPUs, memory and forwarded ports, are
    not part of a snapshot and stay as they are.
    
    Examples:
    
      Restore the VM instance 'my-instance' from the snapshot 'clean':
      $ cubic restore my-instance/clean
    
      Restore without confirmation:
      $ cubic restore --yes my-instance/clean
    
      List the snapshots of a VM instance:
      $ cubic show my-instance
    
    Usage: cubic restore [OPTIONS] <INSTANCE/SNAPSHOT>
    
    Arguments:
      <INSTANCE/SNAPSHOT>
              Snapshot of a virtual machine instance, written as <INSTANCE>/<SNAPSHOT>
    
    Options:
      -y, --yes
              Answer all questions with yes
    
      -v, --verbose
              Increase logging output
    
      -q, --quiet
              Reduce logging output
    
      -h, --help
              Print help (see a summary with '-h')