Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/stratosphere-ve/core/llms.txt

Use this file to discover all available pages before exploring further.

Stratosphere Core manages virtual machines as lightweight JSON configuration files stored in the vms/ directory. Each VM is represented by a single .json file that holds its identity, hardware allocation, network interfaces, and storage configuration. You interact with VMs entirely through the interactive CLI menu, which provides options for creating, deleting, renaming, and monitoring your machines.

How VMs are stored

Every VM corresponds to a file at vms/<vmname>.json. The vms/ directory is created automatically the first time you create a VM. File names map directly to VM names, so a VM named my-server lives at vms/my-server.json.
VM names cannot contain /, \, or . characters. These restrictions prevent path traversal and file-system conflicts.

Current capabilities

The following actions are available in the current release:
CLI optionAction
5View VM resource allocation
6View VM running status
7View both status and resources
8Create a VM
9Delete a VM
10Manage a VM (rename, and more)

What is not yet implemented

The Start, Stop, and Restart actions are present in the manage VM submenu (options 1, 2, and 3) but are currently empty stubs. Selecting them has no effect. These will be wired up to a hypervisor backend in a future release.
Choosing Start, Stop, or Restart in the manage VM submenu does nothing in the current version. Only Rename (option 4) is functional.

Pages in this section

VM config format

Learn the JSON schema that defines each VM’s hardware and network settings.

VM actions

Create, delete, and rename VMs using the CLI menu.

VM Watcher

Monitor running status and resource allocation for your VMs.
Future versions of Stratosphere Core will integrate with a hypervisor to support live start/stop/restart operations, real-time resource metrics, and multi-VM monitoring by ID.

Build docs developers (and LLMs) love