rhel.rst 2.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081
  1. :title: Requirements and Installation on Red Hat Enterprise Linux
  2. :description: Please note this project is currently under heavy development. It should not be used in production.
  3. :keywords: Docker, Docker documentation, requirements, linux, rhel, centos
  4. .. _rhel:
  5. Red Hat Enterprise Linux
  6. ========================
  7. .. include:: install_header.inc
  8. .. include:: install_unofficial.inc
  9. Docker is available for **RHEL** on EPEL. These instructions should work for
  10. both RHEL and CentOS. They will likely work for other binary compatible EL6
  11. distributions as well, but they haven't been tested.
  12. Please note that this package is part of `Extra Packages for Enterprise
  13. Linux (EPEL)`_, a community effort to create and maintain additional packages
  14. for the RHEL distribution.
  15. Also note that due to the current Docker limitations, Docker is able to run
  16. only on the **64 bit** architecture.
  17. Installation
  18. ------------
  19. Firstly, you need to install the EPEL repository. Please follow the `EPEL installation instructions`_.
  20. The ``docker-io`` package provides Docker on EPEL.
  21. If you already have the (unrelated) ``docker`` package installed, it will
  22. conflict with ``docker-io``. There's a `bug report`_ filed for it.
  23. To proceed with ``docker-io`` installation, please remove
  24. ``docker`` first.
  25. Next, let's install the ``docker-io`` package which will install Docker on our host.
  26. .. code-block:: bash
  27. sudo yum -y install docker-io
  28. To update the ``docker-io`` package
  29. .. code-block:: bash
  30. sudo yum -y update docker-io
  31. Now that it's installed, let's start the Docker daemon.
  32. .. code-block:: bash
  33. sudo service docker start
  34. If we want Docker to start at boot, we should also:
  35. .. code-block:: bash
  36. sudo chkconfig docker on
  37. Now let's verify that Docker is working.
  38. .. code-block:: bash
  39. sudo docker run -i -t fedora /bin/bash
  40. **Done!**, now continue with the :ref:`hello_world` example.
  41. Issues?
  42. -------
  43. If you have any issues - please report them directly in the `Red Hat Bugzilla for docker-io component`_.
  44. .. _Extra Packages for Enterprise Linux (EPEL): https://fedoraproject.org/wiki/EPEL
  45. .. _EPEL installation instructions: https://fedoraproject.org/wiki/EPEL#How_can_I_use_these_extra_packages.3F
  46. .. _Red Hat Bugzilla for docker-io component : https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora%20EPEL&component=docker-io
  47. .. _bug report: https://bugzilla.redhat.com/show_bug.cgi?id=1043676