Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions docs/container-machine.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,8 +4,8 @@ Container machine provides a highly integrated Linux environment that works seam

## Why container machines

Containers are typically modeled after an application. A container machine is modeled after a Linux environment. It runs the image's init system allowing you to register long running services or test your application under a process supervisor.
A container machine automatically maps your username and home directory into the Linux environment. Your repositories and dotfiles are available on both platforms. Use editors and tools directly on macOS simultaneously building and running your application inside of the Linux environment.
Containers are typically modeled after an application or task. A container machine uses a standard OCI image to provide a long-lived Linux environment with host integrations such as automatic user and home directory sharing.
Both regular containers and container machines keep their changes until you delete them, but container machines are organized around reusable Linux environments rather than single-application workloads. Your repositories and dotfiles are available on both platforms, so you can use editors and tools directly on macOS while simultaneously building and running your application inside the Linux environment.

- **Edit on the Mac, build inside.** Your repo lives in `$HOME` on macOS and is mounted at `/Users/<username>` inside the container machine. Use your macOS editor or IDE; compile and run inside your container machine.
- **Use macOS-native tooling against Linux artifacts.** Profilers, screenshot tools, browsers, and GUI debuggers on your Mac all see the same files the container machine sees — there is no copy step between "I built it" and "I am inspecting it".
Expand Down