Browse code

Merge pull request #3586 from flavio/add_openSUSE_installation_docs

Added document explaining openSUSE installation

Andy Rothfusz authored on 2014/01/15 04:36:15
Showing 3 changed files
... ...
@@ -174,6 +174,7 @@ Linux:
174 174
 - Centos 6+
175 175
 - Gentoo
176 176
 - ArchLinux
177
+- openSUSE 12.3+
177 178
 
178 179
 Cloud:
179 180
 
... ...
@@ -22,6 +22,7 @@ Contents:
22 22
    fedora
23 23
    archlinux
24 24
    gentoolinux
25
+   openSUSE
25 26
    frugalware
26 27
    vagrant
27 28
    windows
28 29
new file mode 100644
... ...
@@ -0,0 +1,73 @@
0
+:title: Installation on openSUSE
1
+:description: Docker installation on openSUSE.
2
+:keywords: openSUSE, virtualbox, docker, documentation, installation
3
+
4
+.. _openSUSE:
5
+
6
+openSUSE
7
+========
8
+
9
+.. include:: install_header.inc
10
+
11
+.. include:: install_unofficial.inc
12
+
13
+Docker is available in **openSUSE 12.3 and later**. Please note that due to the
14
+current Docker limitations Docker is able to run only on the **64 bit**
15
+architecture.
16
+
17
+Installation
18
+------------
19
+
20
+The ``docker`` package from the `Virtualization project`_ on `OBS`_ provides
21
+Docker on openSUSE.
22
+
23
+
24
+To proceed with Docker installation please add the right Virtualization
25
+repository.
26
+
27
+.. code-block:: bash
28
+
29
+   # openSUSE 12.3
30
+   sudo zypper ar -f http://download.opensuse.org/repositories/Virtualization/openSUSE_12.3/ Virtualization
31
+
32
+   # openSUSE 13.1
33
+   sudo zypper ar -f http://download.opensuse.org/repositories/Virtualization/openSUSE_13.1/ Virtualization
34
+
35
+
36
+Install the Docker package.
37
+
38
+.. code-block:: bash
39
+
40
+   sudo zypper in docker
41
+
42
+It's also possible to install Docker using openSUSE's 1-click install. Just
43
+visit `this`_ page, select your openSUSE version and click on the installation
44
+link. This will add the right repository to your system and it will
45
+also install the `docker` package.
46
+
47
+Now that it's installed, let's start the Docker daemon.
48
+
49
+.. code-block:: bash
50
+
51
+    sudo systemctl start docker
52
+
53
+If we want Docker to start at boot, we should also:
54
+
55
+.. code-block:: bash
56
+
57
+   sudo systemctl enable docker
58
+
59
+The `docker` package creates a new group named `docker`. Users, other than
60
+`root` user, need to be part of this group in order to interact with the
61
+Docker daemon.
62
+
63
+.. code-block:: bash
64
+
65
+   sudo usermod -G docker <username>
66
+
67
+
68
+**Done!**, now continue with the :ref:`hello_world` example.
69
+
70
+.. _Virtualization project: https://build.opensuse.org/project/show/Virtualization
71
+.. _OBS: https://build.opensuse.org/
72
+.. _this: http://software.opensuse.org/package/docker