github.com/circular-dark/docker@v1.7.0/docs/installation/oracle.md (about)

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