.. _ref_cubic_show:

cubic show
==========

.. code-block::

    $ cubic show --help
    Show VM images and instances
    
    Use this command to inspect VM instance configuration and VM image details.
    
    Examples:
    
      Show information of a VM instance
      $ cubic show trixie
      Running:      yes
      Arch:         amd64
      CPUs:         6
      Memory:       16 G
      Disk Used:    5325 M
      Disk Total:   100 G
      User:         cubic
      Isolated:     no
      SSH Port:     54315
      Monitor Port: 54316
      Console Port: 54317
      Forward:      127.0.0.1:4000:4000/tcp
    
      Show all information, adding the process id, file locations and the SSH command
      $ cubic show --all trixie
      ... (fields above, then)
      PID:          12345
      Disk Image:   ~/.local/share/cubic/machines/trixie/machine.img
      Config:       ~/.local/share/cubic/machines/trixie/instance.toml
      SSH Key:      ~/.local/share/cubic/machines/trixie/ssh_client_key
      SSH Host Key: SHA256:ZkAslGjFiUHdGf/WUL8rQvkib4PTvQatUV0OUQSncCA
      SSH:          ssh -i .../trixie/ssh_client_key -p 54315 cubic@localhost
    
      Show information of a VM image
      A plain name is an instance, so an image needs a name or a tag
      $ cubic show ubuntu:latest
      Name:   ubuntu:26.04
      Tags:   resolute, stable, latest
      Arch:   amd64
      Size:   408 M
      Cached: yes
    
      Show all image information, adding checksum, file path and URLs
      $ cubic show --all ubuntu:noble
      ... (fields above, then)
      Checksum:     sha256
      Image File:   ~/.cache/cubic/images/ubuntu_noble_amd64
      Image URL:    https://cloud-images.ubuntu.com/minimal/releases/noble/...
      Checksum URL: https://cloud-images.ubuntu.com/minimal/releases/noble/...
    
    Usage: cubic show [OPTIONS] <NAME>
    
    Arguments:
      <NAME>
              Name of the virtual machine image or instance
              
              A plain name is an instance. An image needs a name or a tag, for example ubuntu:latest.
    
    Options:
      -a, --all
              Show all available information
    
      -v, --verbose
              Increase logging output
    
      -q, --quiet
              Reduce logging output
    
      -h, --help
              Print help (see a summary with '-h')