J Logan
94e06e28a0
- Extract README sections into BUILDING and CONTRIBUTING documents. This should work better than sections in README as it keeps the README short, and the BUILDING and CONTRIBUTING files will stand out in the file list. - Merged localdev document into BUILDING. - Fixed broken links. - Changed DNS setup so later DNS-dependent steps should work. - Added h1 and link to SECURITY document.
container
container is an application 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 application consumes and produces OCI-compliant 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-compliant application.
container uses the Containerization Swift package for low level container, image and process management.
Get started
Install the container application on your Mac.
Requirements
You need an Apple Silicon Mac to run container. To build the application, see the BUILDING document.
container is designed to take advantage of the features of the macOS 16 Developer Preview. You can run the application on macOS Sequoia, but the container maintainers typically will not address Sequoia issues that cannot be reproduced on the macOS 16 Developer Preview.
There are significant networking limitations that impact the usability container on macOS Sequoia.
Install or upgrade
If you're upgrading, first uninstall your existing container while preserving your user data:
uninstall-container.sh -k
Download the latest application installer package from the Github release page.
To install the application, double click the package file and follow the instructions. Enter your administrator password when prompted to give the installer permission to place the application under /usr/local.
Uninstall
Use the uninstall-container.sh script to remove the application from your system. To remove your user data along with the application, run:
uninstall-container.sh -d
To retain your user data so that it is available should you reinstall later, run:
uninstall-container.sh -k
Next steps
- Take a guided tour of
containerby building, running, and publishing a simple web server image. - Learn how to use various
containerfeatures. - Read a brief description and technical overview of
container.