4.9 KiB
Installation
[TOC]
Note: gVisor supports only x86_64 and requires Linux 4.14.77+ (older Linux).
Install latest release
To download and install the latest release manually follow these steps:
(
set -e
URL=https://storage.googleapis.com/gvisor/releases/release/latest
wget ${URL}/runsc ${URL}/runsc.sha512
sha512sum -c runsc.sha512
rm -f runsc.sha512
sudo mv runsc /usr/local/bin
sudo chmod a+rx /usr/local/bin/runsc
)
To install gVisor with Docker, run the following commands:
/usr/local/bin/runsc install
sudo systemctl restart docker
docker run --rm --runtime=runsc hello-world
For more details about using gVisor with Docker, see Docker Quick Start
Note: It is important to copy runsc
to a location that is readable and
executable to all users, since runsc
executes itself as user nobody
to avoid
unnecessary privileges. The /usr/local/bin
directory is a good place to put
the runsc
binary.
Install from an apt
repository
First, appropriate dependencies must be installed to allow apt
to install
packages via https:
sudo apt-get update && \
sudo apt-get install -y \
apt-transport-https \
ca-certificates \
curl \
gnupg-agent \
software-properties-common
Next, the configure the key used to sign archives and the repository:
curl -fsSL https://gvisor.dev/archive.key | sudo apt-key add -
sudo add-apt-repository "deb https://storage.googleapis.com/gvisor/releases release main"
Now the runsc package can be installed:
sudo apt-get update && sudo apt-get install -y runsc
If you have Docker installed, it will be automatically configured.
Versions
The runsc
binaries and repositories are available in multiple versions and
release channels. You should pick the version you'd like to install. For
experimentation, the nightly release is recommended. For production use, the
latest release is recommended.
After selecting an appropriate release channel from the options below, proceed
to the preferred installation mechanism: manual or from an apt
repository.
HEAD
Binaries are available for every commit on the master
branch, and are
available at the following URL:
https://storage.googleapis.com/gvisor/releases/master/latest/runsc
https://storage.googleapis.com/gvisor/releases/master/latest/runsc.sha512
You can use this link with the steps described in Install latest release.
For apt
installation, use the master
to configure the repository:
sudo add-apt-repository "deb https://storage.googleapis.com/gvisor/releases master main"
Nightly
Nightly releases are built most nights from the master branch, and are available at the following URL:
https://storage.googleapis.com/gvisor/releases/nightly/latest/runsc
https://storage.googleapis.com/gvisor/releases/nightly/latest/runsc.sha512
You can use this link with the steps described in Install latest release.
Specific nightly releases can be found at:
https://storage.googleapis.com/gvisor/releases/nightly/${yyyy-mm-dd}/runsc
Note that a release may not be available for every day.
For apt
installation, use the nightly
to configure the repository:
sudo add-apt-repository "deb https://storage.googleapis.com/gvisor/releases nightly main"
Latest release
The latest official release is available at the following URL:
https://storage.googleapis.com/gvisor/releases/release/latest
You can use this link with the steps described in Install latest release.
For apt
installation, use the release
to configure the repository:
sudo add-apt-repository "deb https://storage.googleapis.com/gvisor/releases release main"
Specific release
A given release release is available at the following URL:
https://storage.googleapis.com/gvisor/releases/release/${yyyymmdd}
You can use this link with the steps described in Install latest release.
See the releases page for information about specific releases.
For apt
installation of a specific release, which may include point updates,
use the date of the release for repository, e.g. ${yyyymmdd}
.
sudo add-apt-repository "deb https://storage.googleapis.com/gvisor/releases yyyymmdd main"
Note: only newer releases may be available as
apt
repositories.
Point release
A given point release is available at the following URL:
https://storage.googleapis.com/gvisor/releases/release/${yyyymmdd}.${rc}
You can use this link with the steps described in Install latest release.
Note that apt
installation of a specific point release is not supported.
After installation, try out runsc
by following the
Docker Quick Start or
OCI Quick Start.