Skip to content

docs: clarify container machine vs container semantics#1715

Open
Bortlesboat wants to merge 2 commits into
apple:mainfrom
Bortlesboat:docs/clarify-container-machine-vs-container
Open

docs: clarify container machine vs container semantics#1715
Bortlesboat wants to merge 2 commits into
apple:mainfrom
Bortlesboat:docs/clarify-container-machine-vs-container

Conversation

@Bortlesboat

@Bortlesboat Bortlesboat commented Jun 13, 2026

Copy link
Copy Markdown

Summary

  • clarify that container machines use standard OCI images to provide long-lived Linux environments
  • explain that both regular containers and container machines persist changes until deletion
  • frame the distinction around reusable environment workflows and host user/home integration

Verification

Closes #1700

@afbjorklund

Copy link
Copy Markdown

emphasize the real differentiators: dedicated persistent root storage, init/system-service support,

I don't think the first two are real differentiators, but the new wording makes the intent clear enough.

@afbjorklund

Copy link
Copy Markdown

a container machine is a convenience wrapper around a Linux environment, not a wholly separate runtime model

Not necessarily true, currently container ls and container machine ls are totally separated runtime models...

@jglogan jglogan self-requested a review June 15, 2026 17:01
@Bortlesboat Bortlesboat marked this pull request as ready for review June 16, 2026 03:19
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.

[Request]: strange doc comments about machines versus containers

3 participants