gvisor/content/docs/user_guide/oci.md

+++ title = "OCI Quick Start" weight = 30 +++ This guide will quickly get you started running your first gVisor sandbox container using the runtime directly with the default platform.

Install gVisor

Note: gVisor supports only x86_64 and requires Linux {{< required_linux >}} (older Linux).

{{% readfile file="docs/includes/install_gvisor.md" markdown="true" %}}

Run an OCI compatible container

Now we will create an OCI container bundle to run our container. First we will create a root directory for our bundle.

mkdir bundle
cd bundle

Create a root file system for the container. We will use the Docker hello-world image as the basis for our container.

mkdir rootfs
docker export $(docker create hello-world) | tar -xf - -C rootfs

Next, create an specification file called config.json that contains our container specification. We will update the default command it runs to /hello in the hello-world container.

runsc spec
sed -i 's;"sh";"/hello";' config.json

Finally run the container.

sudo runsc run hello

Next try running gVisor using Docker.