Browse code
Added basic Debian installation page
Docker-DCO-1.1-Signed-off-by: James Turnbull <james@lovedthanlost.net> (github: jamtur01)
James Turnbull authored on 2014/05/18 05:28:39Showing 3 changed files
| ... | ... |
@@ -37,6 +37,7 @@ pages: |
| 37 | 37 |
- ['installation/mac.md', 'Installation', 'Mac OS X'] |
| 38 | 38 |
- ['installation/ubuntulinux.md', 'Installation', 'Ubuntu'] |
| 39 | 39 |
- ['installation/rhel.md', 'Installation', 'Red Hat Enterprise Linux'] |
| 40 |
+- ['installation/debian.md', 'Installation', 'Debian'] |
|
| 40 | 41 |
- ['installation/gentoolinux.md', 'Installation', 'Gentoo'] |
| 41 | 42 |
- ['installation/google.md', 'Installation', 'Google Cloud Platform'] |
| 42 | 43 |
- ['installation/rackspace.md', 'Installation', 'Rackspace Cloud'] |
| ... | ... |
@@ -12,6 +12,7 @@ techniques for installing Docker all the time. |
| 12 | 12 |
- [Ubuntu](ubuntulinux/) |
| 13 | 13 |
- [Red Hat Enterprise Linux](rhel/) |
| 14 | 14 |
- [Fedora](fedora/) |
| 15 |
+ - [Debian](debian/) |
|
| 15 | 16 |
- [Arch Linux](archlinux/) |
| 16 | 17 |
- [CRUX Linux](cruxlinux/) |
| 17 | 18 |
- [Gentoo](gentoolinux/) |
| ... | ... |
@@ -22,4 +23,4 @@ techniques for installing Docker all the time. |
| 22 | 22 |
- [Amazon EC2](amazon/) |
| 23 | 23 |
- [Rackspace Cloud](rackspace/) |
| 24 | 24 |
- [Google Cloud Platform](google/) |
| 25 |
- - [Binaries](binaries/) |
|
| 26 | 25 |
\ No newline at end of file |
| 26 |
+ - [Binaries](binaries/) |
| 27 | 27 |
new file mode 100644 |
| ... | ... |
@@ -0,0 +1,77 @@ |
| 0 |
+page_title: Installation on Debian |
|
| 1 |
+page_description: Instructions for installing Docker on Debian |
|
| 2 |
+page_keywords: Docker, Docker documentation, installation, debian |
|
| 3 |
+ |
|
| 4 |
+# Debian |
|
| 5 |
+ |
|
| 6 |
+> **Note**: |
|
| 7 |
+> Docker is still under heavy development! We don't recommend using it in |
|
| 8 |
+> production yet, but we're getting closer with each release. Please see |
|
| 9 |
+> our blog post, [Getting to Docker 1.0]( |
|
| 10 |
+> http://blog.docker.io/2013/08/getting-to-docker-1-0/) |
|
| 11 |
+ |
|
| 12 |
+Docker is supported on the following versions of Debian: |
|
| 13 |
+ |
|
| 14 |
+ - [*Debian 8.0 Jessie (64-bit)*](#debian-jessie-8-64-bit) |
|
| 15 |
+ |
|
| 16 |
+## Debian Jessie 8.0 (64-bit) |
|
| 17 |
+ |
|
| 18 |
+Debian 8 comes with a 3.14.0 Linux kernel, and a `docker.io` package which |
|
| 19 |
+installs all its prerequisites from Debian's repository. |
|
| 20 |
+ |
|
| 21 |
+> **Note**: |
|
| 22 |
+> Debian contains a much older KDE3/GNOME2 package called ``docker``, so the |
|
| 23 |
+> package and the executable are called ``docker.io``. |
|
| 24 |
+ |
|
| 25 |
+### Installation |
|
| 26 |
+ |
|
| 27 |
+To install the latest Debian package (may not be the latest Docker release): |
|
| 28 |
+ |
|
| 29 |
+ $ sudo apt-get update |
|
| 30 |
+ $ sudo apt-get install docker.io |
|
| 31 |
+ $ sudo ln -sf /usr/bin/docker.io /usr/local/bin/docker |
|
| 32 |
+ |
|
| 33 |
+To verify that everything has worked as expected: |
|
| 34 |
+ |
|
| 35 |
+ $ sudo docker run -i -t ubuntu /bin/bash |
|
| 36 |
+ |
|
| 37 |
+Which should download the `ubuntu` image, and then start `bash` in a container. |
|
| 38 |
+ |
|
| 39 |
+> **Note**: |
|
| 40 |
+> If you want to enable memory and swap accounting see |
|
| 41 |
+> [this](/installation/ubuntulinux/#memory-and-swap-accounting). |
|
| 42 |
+ |
|
| 43 |
+### Giving non-root access |
|
| 44 |
+ |
|
| 45 |
+The `docker` daemon always runs as the `root` user, and since Docker |
|
| 46 |
+version 0.5.2, the `docker` daemon binds to a Unix socket instead of a |
|
| 47 |
+TCP port. By default that Unix socket is owned by the user `root`, and |
|
| 48 |
+so, by default, you can access it with `sudo`. |
|
| 49 |
+ |
|
| 50 |
+Starting in version 0.5.3, if you (or your Docker installer) create a |
|
| 51 |
+Unix group called `docker` and add users to it, then the `docker` daemon |
|
| 52 |
+will make the ownership of the Unix socket read/writable by the `docker` |
|
| 53 |
+group when the daemon starts. The `docker` daemon must always run as the |
|
| 54 |
+root user, but if you run the `docker` client as a user in the `docker` |
|
| 55 |
+group then you don't need to add `sudo` to all the client commands. From |
|
| 56 |
+Docker 0.9.0 you can use the `-G` flag to specify an alternative group. |
|
| 57 |
+ |
|
| 58 |
+> **Warning**: |
|
| 59 |
+> The `docker` group (or the group specified with the `-G` flag) is |
|
| 60 |
+> `root`-equivalent; see [*Docker Daemon Attack Surface*]( |
|
| 61 |
+> /articles/security/#dockersecurity-daemon) details. |
|
| 62 |
+ |
|
| 63 |
+**Example:** |
|
| 64 |
+ |
|
| 65 |
+ # Add the docker group if it doesn't already exist. |
|
| 66 |
+ $ sudo groupadd docker |
|
| 67 |
+ |
|
| 68 |
+ # Add the connected user "${USER}" to the docker group.
|
|
| 69 |
+ # Change the user name to match your preferred user. |
|
| 70 |
+ # You may have to logout and log back in again for |
|
| 71 |
+ # this to take effect. |
|
| 72 |
+ $ sudo gpasswd -a ${USER} docker
|
|
| 73 |
+ |
|
| 74 |
+ # Restart the Docker daemon. |
|
| 75 |
+ $ sudo service docker restart |
|
| 76 |
+ |