container README

The project's README from github.com/apple/container. As one markdown file: README.md.

Containerization logo  container

container is a tool that you can use to create and run Linux containers as lightweight virtual machines on your Mac. It's written in Swift, and optimized for Apple silicon.

The tool consumes and produces OCI-compatible container images, so you can pull and run images from any standard container registry. You can push images that you build to those registries as well, and run the images in any other OCI-compatible application.

container uses the Containerization Swift package for low-level container, image, and process management.

introductory movie showing some basic commands

Get started

Requirements

You need a Mac with Apple silicon to run container. To build it, see the BUILDING document.

container is supported on macOS 26, since it takes advantage of new features and enhancements to virtualization and networking in this release. We do not support older versions of macOS and the container maintainers typically will not address issues that cannot be reproduced on macOS 26.

Initial install

Download the latest signed installer package for container from the GitHub release page.

To install the tool, double-click the package file and follow the instructions. Enter your administrator password when prompted, to give the installer permission to place the installed files under /usr/local.

Start the system service with:

container system start

Run your first container

container run --rm alpine echo hello

This pulls the alpine image, runs it in a lightweight Linux VM, prints hello, and removes the container when it exits. See the tutorial for a fuller walkthrough that builds and publishes an image of your own.

Upgrade or downgrade

For both upgrading and downgrading, you can manually download and install the signed installer package by following the steps from initial install or use the update-container.sh script (installed to /usr/local/bin).

If you're upgrading or downgrading, you must stop your existing container:

container system stop

To upgrade to the latest release, simply run the command below:

/usr/local/bin/update-container.sh

To downgrade, you must uninstall your existing container (the -k flag keeps your user data, while -d removes it):

/usr/local/bin/uninstall-container.sh -k
/usr/local/bin/update-container.sh -v 0.3.0

Start the system service with:

container system start

Uninstall

Use the uninstall-container.sh script (installed to /usr/local/bin) to remove container from your system. To remove your user data along with the tool, run:

/usr/local/bin/uninstall-container.sh -d

To retain your user data so that it is available should you reinstall later, run:

/usr/local/bin/uninstall-container.sh -k

Next steps

Contributing

Contributions to container are welcome and encouraged. Please see our main contributing guide for more information.

Project Status

The container project is under active development. Its release versions are product versions, not semantic versions.

The container CLI compatibility generally preserves backward compatibility within a major release (not breaking existing scripts), however, there may be the odd case where breaking compatibility may be necessary. Note: Features marked experimental (for example, the k8s subcommand) may change and do not guarantee backward compatibility.

The container-apiserver XPC API compatibility preserves forward and backward compatibility within a major version. Other non-public XPC helpers do not guarantee CLI or API compatibility across different versions.

The container application data provides forward compatibility only, guaranteed within one major version. Upgrading to a newer major version may require a specific upgrade path.

container (apple/container)

Searching Database…

50.7K ·GitHub
Container
Что это?Инструмент для создания и запуска Linux-контейнеров в виде легковесных виртуальных машин на Mac, оптимизированный для чипов Apple silicon.
Это замена Docker или что-то другое?Это CLI-инструмент, который работает с OCI-совместимыми образами контейнеров и создает их, поэтому он похож на Docker, но каждый контейнер запускается в собственной легковесной виртуальной машине, а не делит ядро с другими контейнерами.
Как установить и запустить?Скачайте последний подписанный установочный пакет со страницы релизов на GitHub, дважды щелкните по нему, введите пароль администратора, затем запустите системный сервис и выполните контейнер, например загрузите и запустите образ alpine.
Какой Mac нужен для работы?Нужен Mac с чипом Apple silicon; для сборки из исходного кода следуйте отдельному документу BUILDING.
Работает ли на старых версиях macOS?Нет, поддерживается только macOS 26, так как инструмент использует новые возможности виртуализации и сети в этой версии, а мейнтейнеры проекта не будут разбирать проблемы, которые нельзя воспроизвести в ней.
Работает ли он и на Mac с Intel?Нет, он создан специально для Apple silicon и не поддерживает Mac с процессорами Intel.
Можно ли загружать собранные мной образы в реестр?Да, образы, собранные с помощью container, можно загрузить в любой стандартный реестр и запустить в любом другом OCI-совместимом приложении.
Как он управляет контейнерами внутри?Он использует пакет Containerization для Swift для низкоуровневого управления контейнерами, образами и процессами.
Как обновить или удалить его?Можно скачать новый подписанный установщик, использовать скрипт update-container.sh для обновления или понижения версии либо запустить uninstall-container.sh (с флагом -k, чтобы сохранить пользовательские данные, или с флагом -d, чтобы удалить их).
Стабильна ли подкоманда k8s?Нет, функции, помеченные как экспериментальные, например подкоманда k8s, могут меняться и не гарантируют обратной совместимости.
What are similar projects?podman, runc, arcbox, grype, colima, tart, buildkit, lima
Which topics is it in?oci, virtualization, containers, apple-silicon, swift, devops, command-line-tool, docker, self-hosted, cli, macos, open-source
Creator
apple
Size
10 MB
Stars
50.7K
Updated
CommitOct 16Release1.5.0Sep 29
Age
1y
Commits · 90 Days