cubic 0.16.0

Cubic is a lightweight command line manager for virtual machines. It has a simple, daemon-less and rootless design. All Cubic virtual machines run isolated in the user context. Cubic is built on top of QEMU, KVM and cloud-init. Show all supported images: $ cubic images Create a new virtual machine instance: $ cubic create mymachine --image ubuntu:noble List all virtual machine instances: $ cubic instances Start an instance: $ cubic start <instance name> Stop an instance: $ cubic stop <instance name> Open a shell in the instance: $ cubic ssh <machine name> Copy a file from the host to the instance: $ cubic scp <path/to/host/file> <machine>:<path/to/guest/file> Copy a file from the instance to the hots: $ cubic scp <machine>:<path/to/guest/file> <path/to/host/file> 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82

.. _create vm:

Create your First Virtual Machine
=================================

Select a Linux Distribution
---------------------------

Cubic can create a virtual machine for you from a common Linux distribution.
First of all, you need to decide which distribution you want to use.
You can list all supported distributions with:

.. code-block::

    $ cubic image ls
    Name               Arch         Size
    archlinux:latest   amd64   519.3 MiB
    [...]
    debian:12          amd64   424.0 MiB
    debian:bookworm    amd64   424.0 MiB
    [...]
    fedora:42          amd64   507.6 MiB
    fedora:42          arm64   508.4 MiB
    [...]
    opensuse:15.6      amd64   670.3 MiB
    opensuse:15.6      arm64   634.9 MiB
    [...]
    ubuntu:24.04       amd64   243.2 MiB
    ubuntu:noble       amd64   243.2 MiB
    ubuntu:24.04       arm64   212.0 MiB
    ubuntu:noble       arm64   212.0 MiB
    ubuntu:24.10       amd64   249.4 MiB
    [...]

Create the Virtual Machine
--------------------------

In the next step you can create the virtual machine with a single command:

.. code-block::

    $ cubic create example --image debian:bookworm

List all Virtual Machine
------------------------

You can list all your virtual machine with the following command:

.. code-block::

    $ cubic instances
    PID    Name         Arch    CPUs     Memory       Disk   State
           example      amd64      1    1.0 GiB    1.0 GiB   STOPPED

Additional Settings
-------------------

You can also override the default virtual machine settings and define the number of CPUs, the memory size and disk size.
For example to create a virtual machine with 4 CPU cores, 4 GiB of memory and 10 GiB of disk storage use:

.. code-block::

    $ cubic create example --image debian:bookworm --cpus 4 --mem 4G  --disk 10G


Start the virtual machine
-------------------------

Once the virtual machine was created you can start it with:

.. code-block::

    $ cubic start example

Connect with SSH
----------------

When the virtual machine is running you can simply connect over SSH by:

.. code-block::

    $ cubic ssh example