github.com/guilhermebr/docker@v1.4.2-0.20150428121140-67da055cebca/docs/sources/installation/oracle.md (about)

     1  page_title: Installation on Oracle Linux
     2  page_description: Installation instructions for Docker on Oracle Linux.
     3  page_keywords: Docker, Docker documentation, requirements, linux, rhel, centos, oracle, ol
     4  
     5  # Oracle Linux 6 and 7
     6  
     7  You do not require an Oracle Linux Support subscription to install Docker on
     8  Oracle Linux.
     9  
    10  *For Oracle Linux customers with an active support subscription:*
    11  Docker is available in either the `ol6_x86_64_addons` or `ol7_x86_64_addons`
    12  channel for Oracle Linux 6 and Oracle Linux 7 on the [Unbreakable Linux Network
    13  (ULN)](https://linux.oracle.com).
    14  
    15  *For Oracle Linux users without an active support subscription:*
    16  Docker is available in the appropriate `ol6_addons` or `ol7_addons` repository
    17  on [Oracle Public Yum](http://public-yum.oracle.com).
    18  
    19  Docker requires the use of the Unbreakable Enterprise Kernel Release 3 (3.8.13)
    20  or higher on Oracle Linux. This kernel supports the Docker btrfs storage engine
    21  on both Oracle Linux 6 and 7.
    22  
    23  Due to current Docker limitations, Docker is only able to run only on the x86_64
    24  architecture.
    25  
    26  ## To enable the *addons* channel via the Unbreakable Linux Network:
    27  
    28  1. Enable either the *ol6\_x86\_64\_addons* or *ol7\_x86\_64\_addons* channel
    29  via the ULN web interface.
    30  Consult the [Unbreakable Linux Network User's
    31  Guide](http://docs.oracle.com/cd/E52668_01/E39381/html/index.html) for
    32  documentation on subscribing to channels.
    33  
    34  ## To enable the *addons* repository via Oracle Public Yum:
    35  
    36  The latest release of Oracle Linux 6 and 7 are automatically configured to use
    37  the Oracle Public Yum repositories during installation. However, the *addons*
    38  repository is not enabled by default.
    39  
    40  To enable the *addons* repository:
    41  
    42  1. Edit either `/etc/yum.repos.d/public-yum-ol6.repo` or
    43  `/etc/yum.repos.d/public-yum-ol7.repo`
    44  and set `enabled=1` in the `[ol6_addons]` or the `[ol7_addons]` stanza.
    45  
    46  ## To install Docker:
    47  
    48  1. Ensure the appropriate *addons* channel or repository has been enabled.
    49  
    50  2. Use yum to install the Docker package:
    51  
    52  		$ sudo yum install docker
    53  
    54  ## To start Docker:
    55  
    56  1. Now that it's installed, start the Docker daemon:
    57  
    58  	1. On Oracle Linux 6:
    59  
    60  	    	$ sudo service docker start
    61  
    62  	2. On Oracle Linux 7:
    63  
    64  			$ sudo systemctl start docker.service
    65  
    66  2. If you want the Docker daemon to start automatically at boot:
    67  
    68  	1. On Oracle Linux 6:
    69  
    70  	    	$ sudo chkconfig docker on
    71  
    72  	2. On Oracle Linux 7:
    73  
    74  			$ sudo systemctl enable docker.service
    75  
    76  **Done!**
    77  
    78  ## Custom daemon options
    79  
    80  If you need to add an HTTP Proxy, set a different directory or partition for the
    81  Docker runtime files, or make other customizations, read our systemd article to
    82  learn how to [customize your systemd Docker daemon options](/articles/systemd/).
    83  
    84  ## Using the btrfs storage engine
    85  
    86  Docker on Oracle Linux 6 and 7 supports the use of the btrfs storage engine.
    87  Before enabling btrfs support, ensure that `/var/lib/docker` is stored on a
    88  btrfs-based filesystem. Review [Chapter
    89  5](http://docs.oracle.com/cd/E37670_01/E37355/html/ol_btrfs.html) of the [Oracle
    90  Linux Administrator's Solution
    91  Guide](http://docs.oracle.com/cd/E37670_01/E37355/html/index.html) for details
    92  on how to create and mount btrfs filesystems.
    93  
    94  To enable btrfs support on Oracle Linux:
    95  
    96  1. Ensure that `/var/lib/docker` is on a btrfs filesystem.
    97  1. Edit `/etc/sysconfig/docker` and add `-s btrfs` to the `OTHER_ARGS` field.
    98  2. Restart the Docker daemon:
    99  
   100  You can now continue with the [Docker User Guide](/userguide/).
   101  
   102  ## Known issues
   103  
   104  ### Docker unmounts btrfs filesystem on shutdown
   105  If you're running Docker using the btrfs storage engine and you stop the Docker
   106  service, it will unmount the btrfs filesystem during the shutdown process. You
   107  should ensure the filesystem is mounted properly prior to restarting the Docker
   108  service.
   109  
   110  On Oracle Linux 7, you can use a `systemd.mount` definition and modify the
   111  Docker `systemd.service` to depend on the btrfs mount defined in systemd.
   112  
   113  ### SElinux support on Oracle Linux 7
   114  SElinux must be set to `Permissive` or `Disabled` in `/etc/sysconfig/selinux` to
   115  use the btrfs storage engine on Oracle Linux 7.
   116  
   117  ## Further issues?
   118  
   119  If you have a current Basic or Premier Support Subscription for Oracle Linux,
   120  you can report any issues you have with the installation of Docker via a Service
   121  Request at [My Oracle Support](http://support.oracle.com).
   122  
   123  If you do not have an Oracle Linux Support Subscription, you can use the [Oracle
   124  Linux
   125  Forum](https://community.oracle.com/community/server_%26_storage_systems/linux/oracle_linux) for community-based support.