Skip to content

DOC-346: Deprecate Libvirt VM manager in EC2 docs#782

Open
HarshCasper wants to merge 1 commit into
mainfrom
doc-346-doc-ec2-deprecate-libvirt-vmm
Open

DOC-346: Deprecate Libvirt VM manager in EC2 docs#782
HarshCasper wants to merge 1 commit into
mainfrom
doc-346-doc-ec2-deprecate-libvirt-vmm

Conversation

@HarshCasper

@HarshCasper HarshCasper commented Jul 14, 2026

Copy link
Copy Markdown
Member

Summary

  • Mark the Libvirt VM manager as deprecated in the EC2 docs, replacing the preview note and pointing users to Docker or Mock
  • Mark Libvirt-related EC2 config options (EC2_HYPERVISOR_URI, EC2_LIBVIRT_*, EC2_REFERENCE_DOMAIN, and the libvirt value of EC2_VM_MANAGER) as Deprecated

Tracks the product change in localstack-pro#7870.

Fixes DOC-346

Align docs with the product deprecation so users are steered to Docker or Mock VM managers before Libvirt is removed.
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying localstack-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: c597d8a
Status: ✅  Deploy successful!
Preview URL: https://61f64d4f.localstack-docs.pages.dev
Branch Preview URL: https://doc-346-doc-ec2-deprecate-li.localstack-docs.pages.dev

View logs

@nik-localstack nik-localstack left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM 🙌

| `EC2_REFERENCE_DOMAIN` | `my-template-vm` | **Deprecated**. Name of a shut-off Libvirt domain whose configuration will be cloned for all new VMs created by LocalStack. If unset or the domain is not found/not shut-off, LocalStack uses a generic configuration. Used with the deprecated Libvirt VM manager. |
| `EC2_REMOVE_CONTAINERS` | `0`\|`1` (default) | Controls whether created Docker containers are removed at instance termination or LocalStack shuts down. Disable this if there is a need to examine the container filesystem for debugging. |
| `EC2_VM_MANAGER` | `docker`(default)\|`libvirt`\|`mock` | Emulation method to use in LocalStack for AWS. |
| `EC2_VM_MANAGER` | `docker`(default)\|`libvirt` (deprecated)\|`mock` | Emulation method to use in LocalStack for AWS. The `libvirt` value is **Deprecated** and will be removed in a future release. |

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There is the option for kubernetes VMM here but I just realized that we don't document it at all ?

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

let's add it @HarshCasper then :)

@quetzalliwrites quetzalliwrites left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

just a few conflicts to address :)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants