diff --git a/install/README.md b/install/README.md
index e74d770283..57ec55d3d8 100644
--- a/install/README.md
+++ b/install/README.md
@@ -49,7 +49,7 @@ Manual installation instructions are available for [these distributions](#suppor
1. Add the Kata Containers repository to your distro package manager, and import the packages signing key.
2. Install the Kata Containers packages.
3. Install a supported container manager.
-4. Configure the container manager to use `kata-runtime` as the default OCI runtime. Or, for Kata Containers 1.5.0 or above, configure the
+4. Configure the container manager to use `kata-runtime` as the default OCI runtime. Or, for Kata Containers 1.5.0 or above, configure the
`io.containerd.kata.v2` to be the runtime shim (see [containerd runtime v2 (shim API)](https://github.com/containerd/containerd/tree/master/runtime/v2)
and [How to use Kata Containers and CRI (containerd plugin) with Kubernetes](https://github.com/kata-containers/documentation/blob/master/how-to/how-to-use-k8s-with-cri-containerd-and-kata.md)).
@@ -83,15 +83,15 @@ Manual installation instructions are available for [these distributions](#suppor
[Use snap](snap-installation-guide.md) to install Kata Containers from snapcraft.io.
#### Supported Distributions
-|Distro specific installation instructions | Versions |
-|-------------------------------------------------------------------|-----------------|
-|[CentOS](centos-installation-guide.md) | 7 |
-|[Debian](debian-installation-guide.md) | 9 |
-|[Fedora](fedora-installation-guide.md) | 27, 28 |
-|[openSUSE](opensuse-installation-guide.md) | Leap (42.3) |
-|[Red Hat Enterprise Linux (RHEL)](rhel-installation-guide.md) | 7 |
-|[SUSE Linux Enterprise Server (SLES)](sles-installation-guide.md) | SLES 12 SP3 |
-|[Ubuntu](ubuntu-installation-guide.md) | 16.04, 18.04 |
+|Distro specific installation instructions | Versions |
+|-----------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------|
+|[CentOS](centos-installation-guide.md) | 7 |
+|[Debian](debian-installation-guide.md) | 9 |
+|[Fedora](fedora-installation-guide.md) | 27, 28, 29 |
+|[openSUSE](opensuse-installation-guide.md) | [Leap](opensuse-leap-installation-guide.md) (42.3, 15)
[Tumbleweed](opensuse-tumbleweed-installation-guide.md) |
+|[Red Hat Enterprise Linux (RHEL)](rhel-installation-guide.md) | 7 |
+|[SUSE Linux Enterprise Server (SLES)](sles-installation-guide.md)| SLES 12 SP3 |
+|[Ubuntu](ubuntu-installation-guide.md) | 16.04, 18.04 |
## Installing on a Cloud Service Platform
* [Amazon Web Services (AWS)](aws-installation-guide.md)
diff --git a/install/docker/opensuse-docker-install.md b/install/docker/opensuse-docker-install.md
index 120d641bb4..7b3d05bced 100644
--- a/install/docker/opensuse-docker-install.md
+++ b/install/docker/opensuse-docker-install.md
@@ -1,4 +1,4 @@
-# Install Docker for Kata Containers on openSUSE Leap
+# Install Docker for Kata Containers on openSUSE
> **Note:**
>
@@ -14,24 +14,24 @@
> If you wish to use a block based backend, see the options listed on https://github.com/kata-containers/documentation/issues/407.
```bash
- $ sudo zypper -n install libcgroup1
$ sudo zypper -n install docker
```
For more information on installing Docker please refer to the
[Docker Guide](https://software.opensuse.org/package/docker).
-2. Configure Docker to use Kata Containers by default with one of the following methods:
+2. Configure the Docker daemon to use Kata Containers by default, with one of the following methods:
- 1. systemd
+ 1. Specify the runtime options in `/etc/sysconfig/docker`:
```bash
- $ sudo mkdir -p /etc/systemd/system/docker.service.d/
- $ cat <
diff --git a/install/docker/opensuse-tumbleweed-docker-install.md b/install/docker/opensuse-tumbleweed-docker-install.md
new file mode 100644
index 0000000000..8d1c5a369f
--- /dev/null
+++ b/install/docker/opensuse-tumbleweed-docker-install.md
@@ -0,0 +1,14 @@
+# Install Docker for Kata Containers on openSUSE Tumbleweed
+
+Follow the instructions in the generic [openSUSE Docker install guide](opensuse-docker-install.md).
+
diff --git a/install/opensuse-installation-guide.md b/install/opensuse-installation-guide.md
index 7489f63da7..23b19aadec 100644
--- a/install/opensuse-installation-guide.md
+++ b/install/opensuse-installation-guide.md
@@ -1,16 +1,22 @@
-# Install Kata Containers on openSUSE Leap
+# Install Kata Containers on openSUSE
1. Install the Kata Containers components with the following commands:
```bash
$ source /etc/os-release
+ $ DISTRO_REPO=$(sed "s/ /_/g" <<< "$NAME")
+ $ [ -n "$VERSION" ] && DISTRO_REPO+="_${VERSION}"
$ ARCH=$(arch)
$ BRANCH="${BRANCH:-master}"
- $ sudo -E zypper addrepo "http://download.opensuse.org/repositories/home:/katacontainers:/releases:/${ARCH}:/${BRANCH}/openSUSE_Leap_${VERSION_ID}/home:katacontainers:releases:${ARCH}:${BRANCH}.repo"
- $ sudo -E zypper -n --no-gpg-checks install kata-runtime kata-proxy kata-shim
+ $ REPO_ALIAS="kata-${BRANCH}"
+ $ PUBKEY="/tmp/rpm-signkey.pub"
+ $ curl -SsL -o "$PUBKEY" "https://raw.githubusercontent.com/kata-containers/tests/master/data/rpm-signkey.pub"
+ $ sudo -E rpm --import "$PUBKEY"
+ $ zypper lr "$REPO_ALIAS" && sudo -E zypper -n removerepo "$REPO_ALIAS"
+ $ sudo -E zypper addrepo --refresh "http://download.opensuse.org/repositories/home:/katacontainers:/releases:/${ARCH}:/${BRANCH}/${DISTRO_REPO}/" "$REPO_ALIAS"
+ $ sudo -E zypper -n install kata-runtime
```
2. Decide which container manager to use and select the corresponding link that follows:
-
- [Docker](docker/opensuse-docker-install.md)
- - [Kubernetes](https://github.com/kata-containers/documentation/blob/master/Developer-Guide.md#run-kata-containers-with-kubernetes)
+ - [Kubernetes](../Developer-Guide.md#run-kata-containers-with-kubernetes)
diff --git a/install/opensuse-leap-installation-guide.md b/install/opensuse-leap-installation-guide.md
new file mode 100644
index 0000000000..a4bf946f72
--- /dev/null
+++ b/install/opensuse-leap-installation-guide.md
@@ -0,0 +1,19 @@
+# Install Kata Containers on openSUSE Leap
+
+1. Install Kata Containers on openSUSE by following the instructions in the
+[openSUSE install guide](opensuse-installation-guide.md).
+
+
+2. Decide which container manager to use and select the corresponding link that follows:
+ - [Docker](docker/opensuse-leap-docker-install.md)
+ - [Kubernetes](../Developer-Guide.md#run-kata-containers-with-kubernetes)
diff --git a/install/opensuse-tumbleweed-installation-guide.md b/install/opensuse-tumbleweed-installation-guide.md
new file mode 100644
index 0000000000..35ec2f2e3d
--- /dev/null
+++ b/install/opensuse-tumbleweed-installation-guide.md
@@ -0,0 +1,19 @@
+# Install Kata Containers on openSUSE Tumbleweed
+
+1. Install Kata Containers on openSUSE by following the instructions in the
+[openSUSE install guide](opensuse-installation-guide.md).
+
+
+2. Decide which container manager to use and select the corresponding link that follows:
+ - [Docker](docker/opensuse-tumbleweed-docker-install.md)
+ - [Kubernetes](../Developer-Guide.md#run-kata-containers-with-kubernetes)