- Oracle Linux
- Prerequisites
- Install
- Optional configurations
- Create a Docker group
- Configure Docker to start on boot
- Use the btrfs storage engine
- Uninstallation
- Known issues
- Docker unmounts btrfs filesystem on shutdown
- SElinux support on Oracle Linux 7
- Further issues?
- Saved searches
- Use saved searches to filter your results more quickly
- License
- oracle/docker-images
- Name already in use
- Sign In Required
- Launching GitHub Desktop
- Launching GitHub Desktop
- Launching Xcode
- Launching Visual Studio Code
- Latest commit
- Git stats
- Files
- README.md
- About
Oracle Linux
Docker is supported on Oracle Linux 6 and 7. You do not require an Oracle Linux Support subscription to install Docker on Oracle Linux.
Prerequisites
Due to current Docker limitations, Docker is only able to run only on the x86_64 architecture. Docker requires the use of the Unbreakable Enterprise Kernel Release 4 (4.1.12) or higher on Oracle Linux. This kernel supports the Docker btrfs storage engine on both Oracle Linux 6 and 7.
Install
Note: The procedure below installs binaries built by Docker. These binaries are not covered by Oracle Linux support. To ensure Oracle Linux support, please follow the installation instructions provided in the Oracle Linux documentation.
The installation instructions for Oracle Linux 6 and 7 can be found in Chapter 2 of the Docker User’s Guide
- Log into your machine as a user with sudo or root privileges.
- Make sure your existing yum packages are up-to-date.
$ sudo tee /etc/yum.repos.d/docker.repo
$ cat >/etc/yum.repos.d/docker.repo
$ sudo yum install docker-engine
$ sudo service docker start
$ sudo systemctl start docker.service
$ sudo docker run hello-world
Optional configurations
This section contains optional procedures for configuring your Oracle Linux to work better with Docker.
Create a Docker group
The docker daemon binds to a Unix socket instead of a TCP port. By default that Unix socket is owned by the user root and other users can access it with sudo . For this reason, docker daemon always runs as the root user.
To avoid having to use sudo when you use the docker command, create a Unix group called docker and add users to it. When the docker daemon starts, it makes the ownership of the Unix socket read/writable by the docker group.
Warning: The docker group is equivalent to the root user; For details on how this impacts security in your system, see Docker Daemon Attack Surface for details.
To create the docker group and add your user:
- Log into Oracle Linux as a user with sudo privileges.
- Create the docker group.
$ sudo usermod -aG docker username
Cannot connect to the Docker daemon. Is 'docker daemon' running on this host?
Configure Docker to start on boot
You can configure the Docker daemon to start automatically at boot.
$ sudo systemctl enable docker.service
If you need to add an HTTP Proxy, set a different directory or partition for the Docker runtime files, or make other customizations, read our systemd article to learn how to customize your systemd Docker daemon options.
Use the btrfs storage engine
Docker on Oracle Linux 6 and 7 supports the use of the btrfs storage engine. Before enabling btrfs support, ensure that /var/lib/docker is stored on a btrfs-based filesystem. Review Chapter 5 of the Oracle Linux Administrator’s Solution Guide for details on how to create and mount btrfs filesystems.
To enable btrfs support on Oracle Linux:
- Ensure that /var/lib/docker is on a btrfs filesystem.
- Edit /etc/sysconfig/docker and add -s btrfs to the OTHER_ARGS field.
- Restart the Docker daemon:
Uninstallation
To uninstall the Docker package:
$ sudo yum -y remove docker-engine
The above command will not remove images, containers, volumes, or user created configuration files on your host. If you wish to delete all images, containers, and volumes run the following command:
You must delete the user created configuration files manually.
Known issues
Docker unmounts btrfs filesystem on shutdown
If you’re running Docker using the btrfs storage engine and you stop the Docker service, it will unmount the btrfs filesystem during the shutdown process. You should ensure the filesystem is mounted properly prior to restarting the Docker service.
On Oracle Linux 7, you can use a systemd.mount definition and modify the Docker systemd.service to depend on the btrfs mount defined in systemd.
SElinux support on Oracle Linux 7
SElinux must be set to Permissive or Disabled in /etc/sysconfig/selinux to use the btrfs storage engine on Oracle Linux 7.
Further issues?
If you have a current Basic or Premier Support Subscription for Oracle Linux, you can report any issues you have with the installation of Docker via a Service Request at My Oracle Support.
If you do not have an Oracle Linux Support Subscription, you can use the Oracle Linux Forum for community-based support.
Feedback? Questions? Suggestions?
Edit this page, file a ticket, or rate this page:
Saved searches
Use saved searches to filter your results more quickly
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session.
Official source of container configurations, images, and examples for Oracle products and projects
License
oracle/docker-images
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Name already in use
A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Sign In Required
Please sign in to use Codespaces.
Launching GitHub Desktop
If nothing happens, download GitHub Desktop and try again.
Launching GitHub Desktop
If nothing happens, download GitHub Desktop and try again.
Launching Xcode
If nothing happens, download Xcode and try again.
Launching Visual Studio Code
Your codespace will open once ready.
There was a problem preparing your codespace, please try again.
Latest commit
* Fixed hostname not found issue * Added check to prevent user from running container with standard edition parameter on arm64 platforms * Updated condition check for edition name and error message * Fixed lint errors * Fixed lint errors * Fixed lint errors * Fixed lint errors
Git stats
Files
Failed to load latest commit information.
README.md
Docker Images from Oracle
This repository contains Dockerfiles and samples to build Docker images for Oracle commercial products and Oracle sponsored open source projects.
Container Images on GitHub
These images will require you to download any required Oracle commercial software before installation. If you want commercial software downloaded for you, view Pre-Built Images with Commercial Software.
Oracle Commercial Products
- Oracle Access Management
- Oracle BI
- Oracle Cloud Infrastructure Tools
- Oracle Coherence
- Oracle Database
- Oracle Essbase
- Oracle FMW Infrastructure
- Oracle GoldenGate
- Oracle HTTP Server
- Oracle Identity Governance
- Oracle Instant Client (Basic, SDK and SQL*Plus)
- Oracle Java
- Oracle Rest Data Services (ORDS)
- Oracle SOA Suite
- Oracle Tuxedo
- Oracle Unified Directory
- Oracle Unified Directory Service Manager
- Oracle WebLogic Server
- Oracle WebCenter Content
- Oracle WebCenter Portal
- Oracle WebCenter Sites
Oracle Sponsored Open Source Projects
Pre-Built Images with Commercial Software
These sources already contain Oracle commercial software and require license acceptance prior to download:
For support and certification information, please consult the documentation for each product.
For support, bug reporting and feedback about the provided Dockerfiles, please open an issue on GitHub.
If you need general support with running containers on Oracle Linux, you can submit a question under the Containers and Orchestration category of the Applications and Infrastructure Community of Oracle Communities.
This project welcomes contributions from the community. Before submitting a pull request, please review our contribution guide
Please consult the security guide for our responsible security vulnerability disclosure process
Copyright (c) 2019, 2023 Oracle and/or its affiliates.
Released under the Universal Permissive License v1.0 as shown at https://oss.oracle.com/licenses/upl/.
About
Official source of container configurations, images, and examples for Oracle products and projects