From 750d2d8d07069c54c0fbddf4ccd2ba10e9ba9dc9 Mon Sep 17 00:00:00 2001
From: James Turnbull <james@lovedthanlost.net>
Date: Mon, 25 Nov 2013 22:06:18 -0500
Subject: [PATCH] Added Fedora skeleton

---
 docs/sources/installation/fedora.rst | 82 ++++++++++++++++++++++++++++
 docs/sources/installation/index.rst  |  1 +
 2 files changed, 83 insertions(+)
 create mode 100644 docs/sources/installation/fedora.rst

diff --git a/docs/sources/installation/fedora.rst b/docs/sources/installation/fedora.rst
new file mode 100644
index 0000000000..e643dd2276
--- /dev/null
+++ b/docs/sources/installation/fedora.rst
@@ -0,0 +1,82 @@
+:title: Requirements and Installation on Fedora
+:description: Please note this project is currently under heavy development. It should not be used in production.
+:keywords: Docker, Docker documentation, requirements, virtualbox, vagrant, git, ssh, putty, cygwin, linux
+
+.. _fedora:
+
+Fedora
+======
+
+.. include:: install_header.inc
+
+Right now, the officially supported distribution are:
+
+- :ref:`fedora_core19`
+
+Docker has the following dependencies
+
+* Linux kernel 3.8 or later 
+* Device Mapper
+
+.. _fedora_core19:
+
+Fedora Core 19 (64-bit)
+^^^^^^^^^^^^^^^^^^^^^^^
+
+This installation path should work at all times.
+
+Dependencies
+------------
+
+**Linux kernel 3.8**
+
+Due to a bug in LXC, docker works best on the 3.8 kernel or later. Fedora Core
+19 ships with 3.10 so you shouldn't need to update anything. You can confirm 
+the running kernel version with the ``uname`` command.
+
+.. code-block:: bash
+
+    uname -a
+    Linux fedora-19.example.com 3.10.4-300.fc19.x86_64 #1 SMP Tue Jul 30 11:29:05 UTC 2013 x86_64 x86_64 x86_64 GNU/Linux
+
+**Device Mapper**
+
+Fedora Core 19 and later should also ship with Device Mapper that provides
+Docker's filesystem layering.  You can confirm Device Mapper is install by
+checking for the ``sys/class/misc/device-mapper`` file.
+
+.. code-block:: bash
+
+    ls -l /sys/class/misc/device-mapper
+    lrwxrwxrwx. 1 root root 0 Nov 26 03:00 /sys/class/misc/device-mapper -> ../../devices/virtual/misc/device-mapper
+
+If the file is present then Device Mapper is available. If the file is not
+present you can try to install Device Mapper.
+
+.. code-block:: bash
+
+    sudo yum -y install device-mapper
+
+Installation
+------------
+
+Firstly, let's make sure our Fedora host is up-to-date.
+
+.. code-block:: bash
+
+    sudo yum -y upgrade
+
+Next let's install the ``docker-io`` package which will install Docker on our host.
+
+.. code-block:: bash
+
+   sudo yum -y install docker-io
+
+Now let's verify that it worked
+
+.. code-block:: bash
+
+   sudo docker run -i -t ubuntu /bin/bash
+
+**Done!**, now continue with the :ref:`hello_world` example.
+
diff --git a/docs/sources/installation/index.rst b/docs/sources/installation/index.rst
index 9004214181..1f4b12f89c 100644
--- a/docs/sources/installation/index.rst
+++ b/docs/sources/installation/index.rst
@@ -18,6 +18,7 @@ Contents:
    :maxdepth: 1
 
    ubuntulinux
+   fedora
    binaries
    security
    upgrading