Skip to content

turbo install

Create shell integrations for a container by adding Start Menu and optional desktop shortcuts.

Usage

text
turbo install [options] <container> [run flags...]

Run flags you append are stored and forwarded to the resulting shortcut and turbo start command.

Description

  • Adds Start Menu shortcuts by default; you can suppress individual integrations with the --no-* flags.
  • Supports additional desktop integration behaviors such as file associations, URL handlers, shell extensions, and Send To shortcuts.
  • Use turbo containers --no-trunc to list installed containers.
  • Remove an installation with turbo uninstall <container> or through Windows Programs and Features.
  • Forwarded run flags let you persist runtime settings (for example, VM version, diagnostics) in the created shortcut.

Options

  • --format=VALUE — Choose output format; supported value: json.
  • --no-desktop-integration — Disable all host desktop integrations for the installed application.
  • --no-desktop-shortcuts — Do not create desktop shortcuts.
  • --no-file-associations — Do not register file associations.
  • --no-send-to-shortcuts — Do not create Send To menu shortcuts.
  • --no-shell-extensions — Do not register shell extensions.
  • --no-start-menu-shortcuts — Do not create Start Menu shortcuts.
  • --no-url-handlers — Do not register URL handlers.

Examples

bash
# Install a container with default Start Menu shortcut
turbo install demo/app
bash
# Install without shell extensions or URL handlers
turbo install demo/app --no-shell-extensions --no-url-handlers
bash
# Persist runtime flags in the generated shortcut
turbo install demo/app --vm=1.2.3.4 --diagnostic

Output

When you pass --format=json, the command returns JSON output that includes the exit code and an error object when the command fails.