diff --git a/install/ubuntu-installation-guide.md b/install/ubuntu-installation-guide.md new file mode 100644 index 0000000000..24337ba63c --- /dev/null +++ b/install/ubuntu-installation-guide.md @@ -0,0 +1,56 @@ +# Installing Kata Containers on Ubuntu + +Note: +Kata Containers is available for Ubuntu\* **16.04** and **17.10**. +Currently Kata Containers is currently only build for x86_64. + + +This step is only required in case Docker is not installed on the system. +1. Install the latest version of Docker with the following commands: + +``` +$ sudo -E apt-get -y install apt-transport-https ca-certificates wget software-properties-common +$ curl -sL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add - +$ arch=$(dpkg --print-architecture) +$ sudo -E add-apt-repository "deb [arch=${arch}] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" +$ sudo -E apt-get update +$ sudo -E apt-get -y install docker-ce +``` + +For more information on installing Docker please refer to the +[Docker Guide](https://docs.docker.com/engine/installation/linux/ubuntu) + +2. Install the Kata Containers components with the following commands: + +``` +$ sudo sh -c "echo 'deb https://download.opensuse.org/repositories/home:/katacontainers:/release/xUbuntu_$(lsb_release -rs)/ /' >> /etc/apt/sources.list.d/kata-containers.list" +$ curl -sL https://download.opensuse.org/repositories/home:/katacontainers:/release/xUbuntu_$(lsb_release -rs)/Release.key | sudo apt-key add - +$ sudo -E apt-get update +$ sudo -E apt-get -y install kata-runtime kata-proxy kata-shim +``` + +3. Configure Docker to use Kata Containers by default with the following commands: + +``` +$ sudo mkdir -p /etc/systemd/system/docker.service.d/ +$ cat <