github.com/jogo/docker@v1.7.0-rc1/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  ## Installation 
    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  ## Starting 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  ## Uninstallation
   103  
   104  To uninstall the Docker package:
   105  
   106      $ sudo yum -y remove docker
   107  
   108  The above command will not remove images, containers, volumes, or user created
   109  configuration files on your host. If you wish to delete all images, containers,
   110  and volumes run the following command:
   111  
   112      $ rm -rf /var/lib/docker
   113  
   114  You must delete the user created configuration files manually.
   115  
   116  ## Known issues
   117  
   118  ### Docker unmounts btrfs filesystem on shutdown
   119  If you're running Docker using the btrfs storage engine and you stop the Docker
   120  service, it will unmount the btrfs filesystem during the shutdown process. You
   121  should ensure the filesystem is mounted properly prior to restarting the Docker
   122  service.
   123  
   124  On Oracle Linux 7, you can use a `systemd.mount` definition and modify the
   125  Docker `systemd.service` to depend on the btrfs mount defined in systemd.
   126  
   127  ### SElinux support on Oracle Linux 7
   128  SElinux must be set to `Permissive` or `Disabled` in `/etc/sysconfig/selinux` to
   129  use the btrfs storage engine on Oracle Linux 7.
   130  
   131  ## Further issues?
   132  
   133  If you have a current Basic or Premier Support Subscription for Oracle Linux,
   134  you can report any issues you have with the installation of Docker via a Service
   135  Request at [My Oracle Support](http://support.oracle.com).
   136  
   137  If you do not have an Oracle Linux Support Subscription, you can use the [Oracle
   138  Linux
   139  Forum](https://community.oracle.com/community/server_%26_storage_systems/linux/oracle_linux) for community-based support.