1. docker
  2. Commit 47d8ec0a42ce2cd71a0275665f2e7d74a5a56cbf
Browse code

Cover openSUSE and SUSE Linux Enterprise on the same page

Updated the documentation to cover the installation of Docker on
openSUSE and on SUSE Linux Enterprise.

Docker-DCO-1.1-Signed-off-by: Flavio Castelli <fcastelli@suse.com> (github: flavio)

Flavio Castelli authored on 2014/11/17 05:14:45
Showing 3 changed files
docs/sources/installation.md
History View file @ 47d8ec0
... ... 
@@ -16,7 +16,7 @@ techniques for installing Docker all the time.
16 16 
  - [Arch Linux](archlinux/)
17 17 
  - [CRUX Linux](cruxlinux/)
18 18 
  - [Gentoo](gentoolinux/)
19 
- - [openSUSE](openSUSE/)
19 
+ - [openSUSE and SUSE Linux Enterprise](SUSE/)
20 20 
  - [FrugalWare](frugalware/)
21 21 
  - [Mac OS X](mac/)
22 22 
  - [Windows](windows/)
docs/sources/installation/SUSE.md
History View file @ 47d8ec0
23 23 
new file mode 100644
... ... 
@@ -0,0 +1,82 @@
0 
+page_title: Installation on openSUSE and SUSE Linux Enterprise
1 
+page_description: Installation instructions for Docker on openSUSE and on SUSE Linux Enterprise.
2 
+page_keywords: openSUSE, SUSE Linux Enterprise, SUSE, SLE, docker, documentation, installation
3 
+
4 
+# openSUSE
5 
+
6 
+Docker is available in **openSUSE 12.3 and later**. Please note that due
7 
+to its current limitations Docker is able to run only **64 bit** architecture.
8 
+
9 
+Docker is not part of the official repositories of openSUSE 12.3 and
10 
+openSUSE 13.1. Hence  it is neccessary to add the [Virtualization
11 
+repository](https://build.opensuse.org/project/show/Virtualization) from
12 
+[OBS](https://build.opensuse.org/) to install the `docker` package.
13 
+
14 
+Execute one of the following commands to add the Virtualization repository:
15 
+
16 
+    # openSUSE 12.3
17 
+    $ sudo zypper ar -f http://download.opensuse.org/repositories/Virtualization/openSUSE_12.3/ Virtualization
18 
+
19 
+    # openSUSE 13.1
20 
+    $ sudo zypper ar -f http://download.opensuse.org/repositories/Virtualization/openSUSE_13.1/ Virtualization
21 
+
22 
+No extra repository is required for openSUSE 13.2 and later.
23 
+
24 
+# SUSE Linux Enterprise
25 
+
26 
+Docker is available in **SUSE Linux Enterprise 12 and later**. Please note that
27 
+due to its current limitations Docker is able to run only on **64 bit**
28 
+architecture.
29 
+
30 
+# Installation
31 
+
32 
+Install the Docker package.
33 
+
34 
+    $ sudo zypper in docker
35 
+
36 
+Now that it's installed, let's start the Docker daemon.
37 
+
38 
+    $ sudo systemctl start docker
39 
+
40 
+If we want Docker to start at boot, we should also:
41 
+
42 
+    $ sudo systemctl enable docker
43 
+
44 
+The docker package creates a new group named docker. Users, other than
45 
+root user, need to be part of this group in order to interact with the
46 
+Docker daemon. You can add users with:
47 
+
48 
+    $ sudo /usr/sbin/usermod -a -G docker <username>
49 
+
50 
+To verify that everything has worked as expected:
51 
+
52 
+    $ sudo docker run --rm -i -t opensuse /bin/bash
53 
+
54 
+This should download and import the `opensuse` image, and then start `bash` in
55 
+a container. To exit the container type `exit`.
56 
+
57 
+If you want your containers to be able to access the external network you must
58 
+enable the `net.ipv4.ip_forward` rule.
59 
+This can be done using YaST by browsing to the
60 
+`Network Devices -> Network Settings -> Routing` menu and ensuring that the
61 
+`Enable IPv4 Forwarding` box is checked.
62 
+
63 
+This option cannot be changed when networking is handled by the Network Manager.
64 
+In such cases the `/etc/sysconfig/SuSEfirewall2` file needs to be edited by
65 
+hand to ensure the `FW_ROUTE` flag is set to `yes` like so:
66 
+
67 
+    FW_ROUTE="yes"
68 
+
69 
+
70 
+**Done!**
71 
+
72 
+## Custom daemon options
73 
+
74 
+If you need to add an HTTP Proxy, set a different directory or partition for the
75 
+Docker runtime files, or make other customizations, read our systemd article to
76 
+learn how to [customize your systemd Docker daemon options](/articles/systemd/).
77 
+
78 
+## What's next
79 
+
80 
+Continue with the [User Guide](/userguide/).
81 
+
docs/sources/installation/openSUSE.md
History View file @ 47d8ec0
0 82 
deleted file mode 100644
... ... 
@@ -1,83 +0,0 @@
1 
-page_title: Installation on openSUSE
2 
-page_description: Installation instructions for Docker on openSUSE.
3 
-page_keywords: openSUSE, virtualbox, docker, documentation, installation
4 
-
5 
-# openSUSE
6 
-
7 
-Docker is available in **openSUSE 12.3 and later**. Please note that due
8 
-to the current Docker limitations Docker is able to run only on the **64
9 
-bit** architecture.
10 
-
11 
-## Installation
12 
-
13 
-The `docker` package from the [Virtualization
14 
-project](https://build.opensuse.org/project/show/Virtualization) on
15 
-[OBS](https://build.opensuse.org/) provides Docker on openSUSE.
16 
-
17 
-To proceed with Docker installation please add the right Virtualization
18 
-repository.
19 
-
20 
-    # openSUSE 12.3
21 
-    $ sudo zypper ar -f http://download.opensuse.org/repositories/Virtualization/openSUSE_12.3/ Virtualization
22 
-    $ sudo rpm --import http://download.opensuse.org/repositories/Virtualization/openSUSE_12.3/repodata/repomd.xml.key
23 
-
24 
-    # openSUSE 13.1
25 
-    $ sudo zypper ar -f http://download.opensuse.org/repositories/Virtualization/openSUSE_13.1/ Virtualization
26 
-    $ sudo rpm --import http://download.opensuse.org/repositories/Virtualization/openSUSE_13.1/repodata/repomd.xml.key
27 
-
28 
-Install the Docker package.
29 
-
30 
-    $ sudo zypper in docker
31 
-
32 
-It's also possible to install Docker using openSUSE's1-click install.
33 
-Just visit [this](http://software.opensuse.org/package/docker) page,
34 
-select your openSUSE version and click on the installation link. This
35 
-will add the right repository to your system and it will also install
36 
-the docker package.
37 
-
38 
-Now that it's installed, let's start the Docker daemon.
39 
-
40 
-    $ sudo systemctl start docker
41 
-
42 
-If we want Docker to start at boot, we should also:
43 
-
44 
-    $ sudo systemctl enable docker
45 
-
46 
-The docker package creates a new group named docker. Users, other than
47 
-root user, need to be part of this group in order to interact with the
48 
-Docker daemon. You can add users with:
49 
-
50 
-    $ sudo /usr/sbin/usermod -a -G docker <username>
51 
-
52 
-To verify that everything has worked as expected:
53 
-
54 
-    $ sudo docker run --rm -i -t opensuse /bin/bash
55 
-
56 
-This should download and import the `opensuse` image, and then start `bash` in
57 
-a container. To exit the container type `exit`.
58 
-
59 
-If you want your containers to be able to access the external network you must
60 
-enable the `net.ipv4.ip_forward` rule.
61 
-This can be done using YaST by browsing to the
62 
-`Network Devices -> Network Settings -> Routing` menu and ensuring that the
63 
-`Enable IPv4 Forwarding` box is checked.
64 
-
65 
-This option cannot be changed when networking is handled by the Network Manager.
66 
-In such cases the `/etc/sysconfig/SuSEfirewall2` file needs to be edited by
67 
-hand to ensure the `FW_ROUTE` flag is set to `yes` like so:
68 
-
69 
-    FW_ROUTE="yes"
70 
-
71 
-
72 
-**Done!**
73 
-
74 
-## Custom daemon options
75 
-
76 
-If you need to add an HTTP Proxy, set a different directory or partition for the
77 
-Docker runtime files, or make other customizations, read our systemd article to
78 
-learn how to [customize your systemd Docker daemon options](/articles/systemd/).
79 
-
80 
-## What's next
81 
-
82 
-Continue with the [User Guide](/userguide/).
83 
-