自动摘要正在生成中……
No matter your distribution of choice, you’ll need a 64-bit installation and a kernel at 3.10 or newer. Kernels older than 3.10 do not have the necessary features Docker requires to run containers; data loss and kernel panics occur frequently under certain conditions.
Check your current Linux version with uname -r
. You should see something like 3.10.[alphanumeric string].x86_64
.
Debian and Ubuntu
Docker runs on:
- Ubuntu Xenial 16.04 LTS
- Ubuntu Wily 15.10
- Ubuntu Trusty 14.04 LTS
- Ubuntu Precise 12.04 LTS
- Debian testing stretch
- Debian 8.0 Jessie
- Debian 7.0 Wheezy (you must enable backports)
Debian Wheezy
If so, you need to enable backports (if not, ignore this section):
- Log into the system and open a terminal with
sudo
orroot
privileges (or runsudo -i
from your terminal). - Open
/etc/apt/sources.list.d/backports.list
with your favorite text editor (if the file does not exist, create it). - Remove existing entries.
- Add an entry for backports on Debian Wheezy:
- Update your packages:
Ubuntu Precise 12.04
If so, you need to make sure you have the 3.13 kernel version. You must upgrade your kernel:
- Open a terminal on your system.
- Update aptitude:
- Install the additional packages:
- On a graphical Ubuntu environment, you need to additionally run the following:
- Reboot your system:
Update Aptitude
- Log onto your system with a user with
sudo
privileges. - Open a terminal window.
- Purge the older repositories:
- Update your packages, making sure
apt
works withhttps
and the server has CA certificates:
- Get the new GPG key:
- Open or create the file
/etc/apt/sources.list.d/docker.list
in your favorite text editor (you needsudo
orroot
for this). -
Add an entry for your OS
Version Source Ubuntu Precise 12.04 LTS deb https://apt.dockerproject.org/repo ubuntu-precise main
Ubuntu Trusty 14.04 LTS deb https://apt.dockerproject.org/repo ubuntu-trusty main
Ubuntu Wily 15.10 LTS deb https://apt.dockerproject.org/repo ubuntu-wily main
Ubuntu Xenial 16.04 LTS deb https://apt.dockerproject.org/repo ubuntu-xenial main
Debian Wheezy deb https://apt.dockerproject.org/repo debian-wheezy main
Debian Jessie deb https://apt.dockerproject.org/repo debian-jessie main
Debian Stretch/Sid deb https://apt.dockerproject.org/repo debian-stretch main
- Save and close the file.
- Update Aptitude again:
- Verify Aptitude pulls from the right repository:
Install Docker
If you use Ubuntu Trusty, Wily, or Xenial, install the linux-image-extra
kernel package:
- Install Docker:
- Start Docker:
- Verify Docker:
The Docker Group
If you prefer, you can set up a docker
group to run Docker (instead of root
). However, as docker
must have sudo
access, docker
receives the same access as root
.
- Run the following command to create a Docker group on Ubuntu:
-
Log out and back in.
- Run the following command to create a Docker group on Debian:
You may specify a user instead of
${USER}
if you prefer. - Verify a successful Docker installation:
Red Hat Enterprise Linux (RHEL) and CentOS
Docker runs on RHEL 7 and CentOS 7.
Install Docker
Install with Yum
- Log into your system as a user with
sudo
privileges. - Update your system:
sudo yum update -y
. - Add the yum repo (use the code below for both RHEL 7 and CentOS 7):
- Install Docker:
- Start Docker:
- Verify Docker:
Install with the Docker Installation Script
- Log into your system as a user with
sudo
privileges. - Update your system:
- Run Docker’s installation script:
This script adds the
docker.repo
repository and installs Docker. - Start Docker:
- Verify Docker:
The Docker Group
If you prefer, you can set up a docker
group to run Docker (instead of root
). However, as docker
must have sudo
access, docker
receives the same access as root
.
- Run the following command to create a Docker group and add your user to the group (replace USERNAME with your username):
- Log out and back in.
- Verify Docker works without
sudo
:
Start Docker at Boot
Run one of the following:
sudo chkconfig docker on
sudo systemctl enable docker
Common Issues
Note: Members in the docker group have root privileges. Hardening Docker is covered in a future tutorial.
Ubuntu
Ubuntu Utopic 14.10 and 15.05 exist in Docker’s apt
repository without official support. Upgrade to 15.10 or [preferably] 16.04. If you use Ubuntu 12.04, you need to update your kernel.
Debian
If you run Debian Wheezy, you need to update the sources with backports.
“Cannot connect to the Docker daemon. Is ‘docker daemon’ running on this host?”
If you get this error, you need to unset DOCKER_HOST; run unset DOCKER_HOST
to clear the variable.