.. _ref_cubic_modify:

cubic modify
============

.. code-block::

    $ cubic modify --help
    Modify VM instances
    
    Use this command to change the settings of an existing VM instance (CPU, memory,
    disk, etc.). Port forwarding rules (--port/--rm-port) take effect immediately if
    the instance is running. All other changes are applied on the next (re-)start of
    the VM instance.
    
    Examples:
    
      Assign 8 virtual CPUs to a VM instance:
      $ cubic modify example1 --cpus 8
    
      Assign 10 GiB of RAM to a VM instance:
      $ cubic modify example2 --memory 10G
    
      Assign 200 GiB of storage to a VM instance:
      $ cubic modify example3 --disk 200G
    
      Forward the VM instance's SSH port (TCP port 22) to the host on port 2222:
      $ cubic modify example4 --port 2222:22
    
      Forward the VM instance's DNS port (UDP port 53) to the host on port 5353:
      $ cubic modify example5 --port 127.0.0.1:5353:53/udp
    
      Remove DNS port forwarding rule:
      $ cubic modify example6 --rm-port 127.0.0.1:5353:53/udp
    
      Deny network access (host, LAN, internet, ...) of a VM instance:
      $ cubic modify example7 --isolate
    
      Allow network connection of a VM instance:
      $ cubic modify example8 --no-isolate
    
    Usage: cubic modify [OPTIONS] <INSTANCE>
    
    Arguments:
      <INSTANCE>
              Name of the virtual machine instance
    
    Options:
      -c, --cpus <CPUS>
              Number of CPUs for the virtual machine instance
    
      -m, --memory <MEMORY>
              Memory size of the virtual machine instance (e.g. 1G for 1 gigabyte)
    
      -d, --disk <DISK>
              Disk size of the virtual machine instance  (e.g. 10G for 10 gigabytes)
    
      -p, --port <PORT>
              Add port forwarding rule (format: [host_ip:]host_port:guest_port[/(udp|tcp)], e.g. -p 8000:80/tcp)
    
      -P, --rm-port <RM_PORT>
              Remove port forwarding rule (e.g. -P 8000:80)
    
          --isolate
              Isolate VM instance from network
    
          --no-isolate
              Do not isolate VM instance from network (default)
    
      -v, --verbose
              Increase logging output
    
      -q, --quiet
              Reduce logging output
    
      -h, --help
              Print help (see a summary with '-h')