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 exposes VM lifecycle actions through its interactive CLI menu. You can create a new VM, delete an existing one, or rename it. Each action prompts you for a VM name and validates your input before making any changes to the filesystem.
VM name rules
All VM names must follow these rules regardless of which action you are performing:
- Names cannot contain
/, \, or .
- Names must be unique — you cannot create two VMs with the same name
- Names map directly to the file
vms/<name>.json, so they must be valid as a filename component
Entering a name with /, \, or . will immediately reject the operation with an error message. No changes are made to the filesystem.
Create VM (option 8)
Selecting option 8 from the main menu runs the create flow.
Enter a VM name
The CLI prompts you for a name. Type a name that does not contain /, \, or . and press Enter.
Name is validated
Stratosphere checks the name for invalid characters and scans the vms/ directory for an existing VM with the same name.
VM file is created
If the name is valid and unique, vms/<name>.json is created. The vms/ directory is also created automatically if it does not yet exist.
Enter VM name:
my-server
Creating VM with name: my-server
Successfully created VM!
Enter VM name:
my-server
A VM with that name (my-server) already exists. Please choose a different name.
Enter VM name:
bad/name
Invalid VM name. Contains (one or more) invalid characters: /, \, .
Delete VM (option 9)
Selecting option 9 removes a VM’s config file from the filesystem.
Enter the VM name
The CLI asks which VM you want to delete. Type the exact name of the VM.
Name is validated
The name is checked for invalid characters. If valid, vms/<name>.json is removed.
What VM would you like to delete?
my-server
Successfully deleted VM: my-server
Deletion is permanent. There is no confirmation prompt and no undo. The vms/<name>.json file is removed immediately.
Manage VM (option 10)
Selecting option 10 opens a submenu with additional VM management actions.
What would you like to do with your VM?
1. Start
2. Stop
3. Restart
4. Rename
50. Exit
Start (1), Stop (2), and Restart (3) are not implemented in the current version. Selecting any of these options does nothing. They are placeholder stubs awaiting hypervisor integration.
vms/<oldname>.json to vms/<newname>.json.
Enter the current VM name
Type the name of the VM you want to rename.
Enter the new name
Type the new name. It must not contain /, \, or ..
File is renamed
Stratosphere renames vms/<oldname>.json to vms/<newname>.json.
What VM would you like to rename?
my-server
What would you like to rename it to?
prod-server
Successfully renamed VM from my-server to prod-server
