mirror of
https://github.com/moby/moby.git
synced 2022-11-09 12:21:53 -05:00
Docs adding uninstall instructions
Signed-off-by: Megan Kostick <mkostick@us.ibm.com>
This commit is contained in:
parent
7e864a57bc
commit
5eee4058fe
13 changed files with 431 additions and 156 deletions
|
@ -28,7 +28,7 @@ Docker is available in **SUSE Linux Enterprise 12 and later**. Please note that
|
||||||
due to its current limitations Docker is able to run only on **64 bit**
|
due to its current limitations Docker is able to run only on **64 bit**
|
||||||
architecture.
|
architecture.
|
||||||
|
|
||||||
# Installation
|
## Installation
|
||||||
|
|
||||||
Install the Docker package.
|
Install the Docker package.
|
||||||
|
|
||||||
|
@ -76,6 +76,20 @@ 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
|
Docker runtime files, or make other customizations, read our systemd article to
|
||||||
learn how to [customize your systemd Docker daemon options](/articles/systemd/).
|
learn how to [customize your systemd Docker daemon options](/articles/systemd/).
|
||||||
|
|
||||||
|
## Uninstallation
|
||||||
|
|
||||||
|
To uninstall the Docker package:
|
||||||
|
|
||||||
|
$ sudo zypper rm docker
|
||||||
|
|
||||||
|
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:
|
||||||
|
|
||||||
|
$ rm -rf /var/lib/docker
|
||||||
|
|
||||||
|
You must delete the user created configuration files manually.
|
||||||
|
|
||||||
## What's next
|
## What's next
|
||||||
|
|
||||||
Continue with the [User Guide](/userguide/).
|
Continue with the [User Guide](/userguide/).
|
||||||
|
|
|
@ -30,13 +30,13 @@ in the packages. The core dependencies are:
|
||||||
|
|
||||||
For the normal package a simple
|
For the normal package a simple
|
||||||
|
|
||||||
pacman -S docker
|
$ sudo pacman -S docker
|
||||||
|
|
||||||
is all that is needed.
|
is all that is needed.
|
||||||
|
|
||||||
For the AUR package execute:
|
For the AUR package execute:
|
||||||
|
|
||||||
yaourt -S docker-git
|
$ sudo yaourt -S docker-git
|
||||||
|
|
||||||
The instructions here assume **yaourt** is installed. See [Arch User
|
The instructions here assume **yaourt** is installed. See [Arch User
|
||||||
Repository](https://wiki.archlinux.org/index.php/Arch_User_Repository#Installing_packages)
|
Repository](https://wiki.archlinux.org/index.php/Arch_User_Repository#Installing_packages)
|
||||||
|
@ -59,3 +59,21 @@ To start on system boot:
|
||||||
If you need to add an HTTP Proxy, set a different directory or partition for the
|
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
|
Docker runtime files, or make other customizations, read our systemd article to
|
||||||
learn how to [customize your systemd Docker daemon options](/articles/systemd/).
|
learn how to [customize your systemd Docker daemon options](/articles/systemd/).
|
||||||
|
|
||||||
|
## Uninstallation
|
||||||
|
|
||||||
|
To uninstall the Docker package:
|
||||||
|
|
||||||
|
$ sudo pacman -R docker
|
||||||
|
|
||||||
|
To uninstall the Docker package and dependencies that are no longer needed:
|
||||||
|
|
||||||
|
$ sudo pacman -Rns docker
|
||||||
|
|
||||||
|
The above commands 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:
|
||||||
|
|
||||||
|
$ rm -rf /var/lib/docker
|
||||||
|
|
||||||
|
You must delete the user created configuration files manually.
|
||||||
|
|
|
@ -25,7 +25,10 @@ To run Docker on [CentOS-6.5](http://www.centos.org) or later, you will need
|
||||||
kernel version 2.6.32-431 or higher as this has specific kernel fixes to allow
|
kernel version 2.6.32-431 or higher as this has specific kernel fixes to allow
|
||||||
Docker to run.
|
Docker to run.
|
||||||
|
|
||||||
## Installing Docker - CentOS-7
|
## CentOS-7
|
||||||
|
|
||||||
|
### Installation
|
||||||
|
|
||||||
Docker is included by default in the CentOS-Extras repository. To install
|
Docker is included by default in the CentOS-Extras repository. To install
|
||||||
run the following command:
|
run the following command:
|
||||||
|
|
||||||
|
@ -33,7 +36,23 @@ run the following command:
|
||||||
|
|
||||||
Please continue with the [Starting the Docker daemon](#starting-the-docker-daemon).
|
Please continue with the [Starting the Docker daemon](#starting-the-docker-daemon).
|
||||||
|
|
||||||
## Installing Docker - CentOS-6.5
|
### Uninstallation
|
||||||
|
|
||||||
|
To uninstall the Docker package:
|
||||||
|
|
||||||
|
$ sudo yum -y remove docker
|
||||||
|
|
||||||
|
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:
|
||||||
|
|
||||||
|
$ rm -rf /var/lib/docker
|
||||||
|
|
||||||
|
You must delete the user created configuration files manually.
|
||||||
|
|
||||||
|
## CentOS-6.5
|
||||||
|
|
||||||
|
### Installation
|
||||||
|
|
||||||
For CentOS-6.5, the Docker package is part of [Extra Packages
|
For CentOS-6.5, the Docker package is part of [Extra Packages
|
||||||
for Enterprise Linux (EPEL)](https://fedoraproject.org/wiki/EPEL) repository,
|
for Enterprise Linux (EPEL)](https://fedoraproject.org/wiki/EPEL) repository,
|
||||||
|
@ -57,6 +76,20 @@ Next, let's install the `docker-io` package which will install Docker on our hos
|
||||||
|
|
||||||
Please continue with the [Starting the Docker daemon](#starting-the-docker-daemon).
|
Please continue with the [Starting the Docker daemon](#starting-the-docker-daemon).
|
||||||
|
|
||||||
|
### Uninstallation
|
||||||
|
|
||||||
|
To uninstall the Docker package:
|
||||||
|
|
||||||
|
$ sudo yum -y remove docker-io
|
||||||
|
|
||||||
|
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:
|
||||||
|
|
||||||
|
$ rm -rf /var/lib/docker
|
||||||
|
|
||||||
|
You must delete the user created configuration files manually.
|
||||||
|
|
||||||
## Manual installation of latest Docker release
|
## Manual installation of latest Docker release
|
||||||
|
|
||||||
While using a package is the recommended way of installing Docker,
|
While using a package is the recommended way of installing Docker,
|
||||||
|
|
|
@ -15,9 +15,9 @@ The `docker` port will build and install the latest tagged version of Docker.
|
||||||
|
|
||||||
## Installation
|
## Installation
|
||||||
|
|
||||||
Assuming you have contrib enabled, update your ports tree and install docker (*as root*):
|
Assuming you have contrib enabled, update your ports tree and install docker:
|
||||||
|
|
||||||
# prt-get depinst docker
|
$ sudo prt-get depinst docker
|
||||||
|
|
||||||
|
|
||||||
## Kernel requirements
|
## Kernel requirements
|
||||||
|
@ -27,7 +27,7 @@ the necessary modules enabled for the Docker Daemon to function correctly.
|
||||||
|
|
||||||
Please read the `README`:
|
Please read the `README`:
|
||||||
|
|
||||||
$ prt-get readme docker
|
$ sudo prt-get readme docker
|
||||||
|
|
||||||
The `docker` port installs the `contrib/check-config.sh` script
|
The `docker` port installs the `contrib/check-config.sh` script
|
||||||
provided by the Docker contributors for checking your kernel
|
provided by the Docker contributors for checking your kernel
|
||||||
|
@ -39,9 +39,9 @@ To check your Kernel configuration run:
|
||||||
|
|
||||||
## Starting Docker
|
## Starting Docker
|
||||||
|
|
||||||
There is a rc script created for Docker. To start the Docker service (*as root*):
|
There is a rc script created for Docker. To start the Docker service:
|
||||||
|
|
||||||
# /etc/rc.d/docker start
|
$ sudo /etc/rc.d/docker start
|
||||||
|
|
||||||
To start on system boot:
|
To start on system boot:
|
||||||
|
|
||||||
|
@ -60,6 +60,20 @@ or use it as part of your `FROM` line in your `Dockerfile(s)`.
|
||||||
There are also user contributed [CRUX based image(s)](https://registry.hub.docker.com/repos/crux/) on the Docker Hub.
|
There are also user contributed [CRUX based image(s)](https://registry.hub.docker.com/repos/crux/) on the Docker Hub.
|
||||||
|
|
||||||
|
|
||||||
|
## Uninstallation
|
||||||
|
|
||||||
|
To uninstall the Docker package:
|
||||||
|
|
||||||
|
$ sudo prt-get remove docker
|
||||||
|
|
||||||
|
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:
|
||||||
|
|
||||||
|
$ rm -rf /var/lib/docker
|
||||||
|
|
||||||
|
You must delete the user created configuration files manually.
|
||||||
|
|
||||||
## Issues
|
## Issues
|
||||||
|
|
||||||
If you have any issues please file a bug with the
|
If you have any issues please file a bug with the
|
||||||
|
|
|
@ -37,6 +37,24 @@ container runs, it prints an informational message. Then, it exits.
|
||||||
> If you want to enable memory and swap accounting see
|
> If you want to enable memory and swap accounting see
|
||||||
> [this](/installation/ubuntulinux/#memory-and-swap-accounting).
|
> [this](/installation/ubuntulinux/#memory-and-swap-accounting).
|
||||||
|
|
||||||
|
### Uninstallation
|
||||||
|
|
||||||
|
To uninstall the Docker package:
|
||||||
|
|
||||||
|
$ sudo apt-get purge docker-io
|
||||||
|
|
||||||
|
To uninstall the Docker package and dependencies that are no longer needed:
|
||||||
|
|
||||||
|
$ sudo apt-get autoremove --purge docker-io
|
||||||
|
|
||||||
|
The above commands 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:
|
||||||
|
|
||||||
|
$ rm -rf /var/lib/docker
|
||||||
|
|
||||||
|
You must delete the user created configuration files manually.
|
||||||
|
|
||||||
## Debian Wheezy/Stable 7.x (64-bit)
|
## Debian Wheezy/Stable 7.x (64-bit)
|
||||||
|
|
||||||
Docker requires Kernel 3.8+, while Wheezy ships with Kernel 3.2 (for more details
|
Docker requires Kernel 3.8+, while Wheezy ships with Kernel 3.2 (for more details
|
||||||
|
@ -74,6 +92,24 @@ which is officially supported by Docker.
|
||||||
>
|
>
|
||||||
> $ wget -qO- https://get.docker.com/gpg | sudo apt-key add -
|
> $ wget -qO- https://get.docker.com/gpg | sudo apt-key add -
|
||||||
|
|
||||||
|
### Uninstallation
|
||||||
|
|
||||||
|
To uninstall the Docker package:
|
||||||
|
|
||||||
|
$ sudo apt-get purge lxc-docker
|
||||||
|
|
||||||
|
To uninstall the Docker package and dependencies that are no longer needed:
|
||||||
|
|
||||||
|
$ sudo apt-get autoremove --purge lxc-docker
|
||||||
|
|
||||||
|
The above commands 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:
|
||||||
|
|
||||||
|
$ rm -rf /var/lib/docker
|
||||||
|
|
||||||
|
You must delete the user created configuration files manually.
|
||||||
|
|
||||||
## Giving non-root access
|
## Giving non-root access
|
||||||
|
|
||||||
The `docker` daemon always runs as the `root` user and the `docker`
|
The `docker` daemon always runs as the `root` user and the `docker`
|
||||||
|
|
|
@ -13,19 +13,37 @@ Currently the Fedora project will only support Docker when running on kernels
|
||||||
shipped by the distribution. There are kernel changes which will cause issues
|
shipped by the distribution. There are kernel changes which will cause issues
|
||||||
if one decides to step outside that box and run non-distribution kernel packages.
|
if one decides to step outside that box and run non-distribution kernel packages.
|
||||||
|
|
||||||
## Fedora 21 and later installation
|
## Fedora 21 and later
|
||||||
|
|
||||||
Install the `docker` package which will install Docker on our host.
|
### Installation
|
||||||
|
|
||||||
|
Install the Docker package which will install Docker on our host.
|
||||||
|
|
||||||
$ sudo yum -y install docker
|
$ sudo yum -y install docker
|
||||||
|
|
||||||
To update the `docker` package:
|
To update the Docker package:
|
||||||
|
|
||||||
$ sudo yum -y update docker
|
$ sudo yum -y update docker
|
||||||
|
|
||||||
Please continue with the [Starting the Docker daemon](#starting-the-docker-daemon).
|
Please continue with the [Starting the Docker daemon](#starting-the-docker-daemon).
|
||||||
|
|
||||||
## Fedora 20 installation
|
### Uninstallation
|
||||||
|
|
||||||
|
To uninstall the Docker package:
|
||||||
|
|
||||||
|
$ sudo yum -y remove docker
|
||||||
|
|
||||||
|
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:
|
||||||
|
|
||||||
|
$ rm -rf /var/lib/docker
|
||||||
|
|
||||||
|
You must delete the user created configuration files manually.
|
||||||
|
|
||||||
|
## Fedora 20
|
||||||
|
|
||||||
|
### Installation
|
||||||
|
|
||||||
For `Fedora 20`, there is a package name conflict with a system tray application
|
For `Fedora 20`, there is a package name conflict with a system tray application
|
||||||
and its executable, so the Docker RPM package was called `docker-io`.
|
and its executable, so the Docker RPM package was called `docker-io`.
|
||||||
|
@ -36,12 +54,26 @@ package first.
|
||||||
$ sudo yum -y remove docker
|
$ sudo yum -y remove docker
|
||||||
$ sudo yum -y install docker-io
|
$ sudo yum -y install docker-io
|
||||||
|
|
||||||
To update the `docker` package:
|
To update the Docker package:
|
||||||
|
|
||||||
$ sudo yum -y update docker-io
|
$ sudo yum -y update docker-io
|
||||||
|
|
||||||
Please continue with the [Starting the Docker daemon](#starting-the-docker-daemon).
|
Please continue with the [Starting the Docker daemon](#starting-the-docker-daemon).
|
||||||
|
|
||||||
|
### Uninstallation
|
||||||
|
|
||||||
|
To uninstall the Docker package:
|
||||||
|
|
||||||
|
$ sudo yum -y remove docker-io
|
||||||
|
|
||||||
|
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:
|
||||||
|
|
||||||
|
$ rm -rf /var/lib/docker
|
||||||
|
|
||||||
|
You must delete the user created configuration files manually.
|
||||||
|
|
||||||
## Starting the Docker daemon
|
## Starting the Docker daemon
|
||||||
|
|
||||||
Now that it's installed, let's start the Docker daemon.
|
Now that it's installed, let's start the Docker daemon.
|
||||||
|
|
|
@ -28,7 +28,7 @@ in the packages. The core dependencies are:
|
||||||
|
|
||||||
A simple
|
A simple
|
||||||
|
|
||||||
pacman -S lxc-docker
|
$ sudo pacman -S lxc-docker
|
||||||
|
|
||||||
is all that is needed.
|
is all that is needed.
|
||||||
|
|
||||||
|
@ -48,3 +48,21 @@ To start on system boot:
|
||||||
If you need to add an HTTP Proxy, set a different directory or partition for the
|
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
|
Docker runtime files, or make other customizations, read our systemd article to
|
||||||
learn how to [customize your systemd Docker daemon options](/articles/systemd/).
|
learn how to [customize your systemd Docker daemon options](/articles/systemd/).
|
||||||
|
|
||||||
|
## Uninstallation
|
||||||
|
|
||||||
|
To uninstall the Docker package:
|
||||||
|
|
||||||
|
$ sudo pacman -R lxc-docker
|
||||||
|
|
||||||
|
To uninstall the Docker package and dependencies that are no longer needed:
|
||||||
|
|
||||||
|
$ sudo pacman -Rns lxc-docker
|
||||||
|
|
||||||
|
The above commands 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:
|
||||||
|
|
||||||
|
$ rm -rf /var/lib/docker
|
||||||
|
|
||||||
|
You must delete the user created configuration files manually.
|
||||||
|
|
|
@ -95,3 +95,21 @@ To start on system boot:
|
||||||
If you need to add an HTTP Proxy, set a different directory or partition for the
|
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
|
Docker runtime files, or make other customizations, read our systemd article to
|
||||||
learn how to [customize your systemd Docker daemon options](/articles/systemd/).
|
learn how to [customize your systemd Docker daemon options](/articles/systemd/).
|
||||||
|
|
||||||
|
## Uninstallation
|
||||||
|
|
||||||
|
To uninstall the Docker package:
|
||||||
|
|
||||||
|
$ sudo emerge -cav app-emulation/docker
|
||||||
|
|
||||||
|
To uninstall the Docker package and dependencies that are no longer needed:
|
||||||
|
|
||||||
|
$ sudo emerge -C app-emulation/docker
|
||||||
|
|
||||||
|
The above commands 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:
|
||||||
|
|
||||||
|
$ rm -rf /var/lib/docker
|
||||||
|
|
||||||
|
You must delete the user created configuration files manually.
|
||||||
|
|
|
@ -2,7 +2,7 @@ page_title: Installation on Mac OS X
|
||||||
page_description: Instructions for installing Docker on OS X using boot2docker.
|
page_description: Instructions for installing Docker on OS X using boot2docker.
|
||||||
page_keywords: Docker, Docker documentation, requirements, boot2docker, VirtualBox, SSH, Linux, OSX, OS X, Mac
|
page_keywords: Docker, Docker documentation, requirements, boot2docker, VirtualBox, SSH, Linux, OSX, OS X, Mac
|
||||||
|
|
||||||
# Install Docker on Mac OS X
|
# Mac OS X
|
||||||
|
|
||||||
You can install Docker using Boot2Docker to run `docker` commands at your command-line.
|
You can install Docker using Boot2Docker to run `docker` commands at your command-line.
|
||||||
Choose this installation if you are familiar with the command-line or plan to
|
Choose this installation if you are familiar with the command-line or plan to
|
||||||
|
@ -55,17 +55,17 @@ When you start the `boot2docker` process, the VM is assigned an IP address. Unde
|
||||||
practice, work through the exercises on this page.
|
practice, work through the exercises on this page.
|
||||||
|
|
||||||
|
|
||||||
### Install Boot2Docker
|
### Installation
|
||||||
|
|
||||||
1. Go to the [boot2docker/osx-installer ](
|
1. Go to the [boot2docker/osx-installer ](
|
||||||
https://github.com/boot2docker/osx-installer/releases/latest) release page.
|
https://github.com/boot2docker/osx-installer/releases/latest) release page.
|
||||||
|
|
||||||
4. Download Boot2Docker by clicking `Boot2Docker-x.x.x.pkg` in the "Downloads"
|
4. Download Boot2Docker by clicking `Boot2Docker-x.x.x.pkg` in the "Downloads"
|
||||||
section.
|
section.
|
||||||
|
|
||||||
3. Install Boot2Docker by double-clicking the package.
|
3. Install Boot2Docker by double-clicking the package.
|
||||||
|
|
||||||
The installer places Boot2Docker in your "Applications" folder.
|
The installer places Boot2Docker in your "Applications" folder.
|
||||||
|
|
||||||
The installation places the `docker` and `boot2docker` binaries in your
|
The installation places the `docker` and `boot2docker` binaries in your
|
||||||
`/usr/local/bin` directory.
|
`/usr/local/bin` directory.
|
||||||
|
@ -96,30 +96,32 @@ application:
|
||||||
Once the launch completes, you can run `docker` commands. A good way to verify
|
Once the launch completes, you can run `docker` commands. A good way to verify
|
||||||
your setup succeeded is to run the `hello-world` container.
|
your setup succeeded is to run the `hello-world` container.
|
||||||
|
|
||||||
$ docker run hello-world
|
$ docker run hello-world
|
||||||
Unable to find image 'hello-world:latest' locally
|
Unable to find image 'hello-world:latest' locally
|
||||||
511136ea3c5a: Pull complete
|
511136ea3c5a: Pull complete
|
||||||
31cbccb51277: Pull complete
|
31cbccb51277: Pull complete
|
||||||
e45a5af57b00: Pull complete
|
e45a5af57b00: Pull complete
|
||||||
hello-world:latest: The image you are pulling has been verified. Important: image verification is a tech preview feature and should not be relied on to provide security.
|
hello-world:latest: The image you are pulling has been verified.
|
||||||
Status: Downloaded newer image for hello-world:latest
|
Important: image verification is a tech preview feature and should not be
|
||||||
Hello from Docker.
|
relied on to provide security.
|
||||||
This message shows that your installation appears to be working correctly.
|
Status: Downloaded newer image for hello-world:latest
|
||||||
|
Hello from Docker.
|
||||||
|
This message shows that your installation appears to be working correctly.
|
||||||
|
|
||||||
To generate this message, Docker took the following steps:
|
To generate this message, Docker took the following steps:
|
||||||
1. The Docker client contacted the Docker daemon.
|
1. The Docker client contacted the Docker daemon.
|
||||||
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
|
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
|
||||||
(Assuming it was not already locally available.)
|
(Assuming it was not already locally available.)
|
||||||
3. The Docker daemon created a new container from that image which runs the
|
3. The Docker daemon created a new container from that image which runs the
|
||||||
executable that produces the output you are currently reading.
|
executable that produces the output you are currently reading.
|
||||||
4. The Docker daemon streamed that output to the Docker client, which sent it
|
4. The Docker daemon streamed that output to the Docker client, which sent it
|
||||||
to your terminal.
|
to your terminal.
|
||||||
|
|
||||||
To try something more ambitious, you can run an Ubuntu container with:
|
To try something more ambitious, you can run an Ubuntu container with:
|
||||||
$ docker run -it ubuntu bash
|
$ docker run -it ubuntu bash
|
||||||
|
|
||||||
For more examples and ideas, visit:
|
For more examples and ideas, visit:
|
||||||
http://docs.docker.com/userguide/
|
http://docs.docker.com/userguide/
|
||||||
|
|
||||||
|
|
||||||
A more typical way to start and stop `boot2docker` is using the command line.
|
A more typical way to start and stop `boot2docker` is using the command line.
|
||||||
|
@ -130,36 +132,36 @@ Initialize and run `boot2docker` from the command line, do the following:
|
||||||
|
|
||||||
1. Create a new Boot2Docker VM.
|
1. Create a new Boot2Docker VM.
|
||||||
|
|
||||||
$ boot2docker init
|
$ boot2docker init
|
||||||
|
|
||||||
This creates a new virtual machine. You only need to run this command once.
|
This creates a new virtual machine. You only need to run this command once.
|
||||||
|
|
||||||
2. Start the `boot2docker` VM.
|
2. Start the `boot2docker` VM.
|
||||||
|
|
||||||
$ boot2docker start
|
$ boot2docker start
|
||||||
|
|
||||||
3. Display the environment variables for the Docker client.
|
3. Display the environment variables for the Docker client.
|
||||||
|
|
||||||
$ boot2docker shellinit
|
$ boot2docker shellinit
|
||||||
Writing /Users/mary/.boot2docker/certs/boot2docker-vm/ca.pem
|
Writing /Users/mary/.boot2docker/certs/boot2docker-vm/ca.pem
|
||||||
Writing /Users/mary/.boot2docker/certs/boot2docker-vm/cert.pem
|
Writing /Users/mary/.boot2docker/certs/boot2docker-vm/cert.pem
|
||||||
Writing /Users/mary/.boot2docker/certs/boot2docker-vm/key.pem
|
Writing /Users/mary/.boot2docker/certs/boot2docker-vm/key.pem
|
||||||
export DOCKER_HOST=tcp://192.168.59.103:2376
|
export DOCKER_HOST=tcp://192.168.59.103:2376
|
||||||
export DOCKER_CERT_PATH=/Users/mary/.boot2docker/certs/boot2docker-vm
|
export DOCKER_CERT_PATH=/Users/mary/.boot2docker/certs/boot2docker-vm
|
||||||
export DOCKER_TLS_VERIFY=1
|
export DOCKER_TLS_VERIFY=1
|
||||||
|
|
||||||
The specific paths and address on your machine will be different.
|
The specific paths and address on your machine will be different.
|
||||||
|
|
||||||
4. To set the environment variables in your shell do the following:
|
4. To set the environment variables in your shell do the following:
|
||||||
|
|
||||||
$ eval "$(boot2docker shellinit)"
|
$ eval "$(boot2docker shellinit)"
|
||||||
|
|
||||||
You can also set them manually by using the `export` commands `boot2docker`
|
You can also set them manually by using the `export` commands `boot2docker`
|
||||||
returns.
|
returns.
|
||||||
|
|
||||||
5. Run the `hello-world` container to verify your setup.
|
5. Run the `hello-world` container to verify your setup.
|
||||||
|
|
||||||
$ docker run hello-world
|
$ docker run hello-world
|
||||||
|
|
||||||
|
|
||||||
## Basic Boot2Docker exercises
|
## Basic Boot2Docker exercises
|
||||||
|
@ -167,8 +169,8 @@ Initialize and run `boot2docker` from the command line, do the following:
|
||||||
At this point, you should have `boot2docker` running and the `docker` client
|
At this point, you should have `boot2docker` running and the `docker` client
|
||||||
environment initialized. To verify this, run the following commands:
|
environment initialized. To verify this, run the following commands:
|
||||||
|
|
||||||
$ boot2docker status
|
$ boot2docker status
|
||||||
$ docker version
|
$ docker version
|
||||||
|
|
||||||
Work through this section to try some practical container tasks using `boot2docker` VM.
|
Work through this section to try some practical container tasks using `boot2docker` VM.
|
||||||
|
|
||||||
|
@ -176,52 +178,52 @@ Work through this section to try some practical container tasks using `boot2dock
|
||||||
|
|
||||||
1. Start an NGINX container on the DOCKER_HOST.
|
1. Start an NGINX container on the DOCKER_HOST.
|
||||||
|
|
||||||
$ docker run -d -P --name web nginx
|
$ docker run -d -P --name web nginx
|
||||||
|
|
||||||
Normally, the `docker run` commands starts a container, runs it, and then
|
Normally, the `docker run` commands starts a container, runs it, and then
|
||||||
exits. The `-d` flag keeps the container running in the background
|
exits. The `-d` flag keeps the container running in the background
|
||||||
after the `docker run` command completes. The `-P` flag publishes exposed ports from the
|
after the `docker run` command completes. The `-P` flag publishes exposed ports from the
|
||||||
container to your local host; this lets you access them from your Mac.
|
container to your local host; this lets you access them from your Mac.
|
||||||
|
|
||||||
2. Display your running container with `docker ps` command
|
2. Display your running container with `docker ps` command
|
||||||
|
|
||||||
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
|
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
|
||||||
5fb65ff765e9 nginx:latest "nginx -g 'daemon of 3 minutes ago Up 3 minutes 0.0.0.0:49156->443/tcp, 0.0.0.0:49157->80/tcp web
|
5fb65ff765e9 nginx:latest "nginx -g 'daemon of 3 minutes ago Up 3 minutes 0.0.0.0:49156->443/tcp, 0.0.0.0:49157->80/tcp web
|
||||||
|
|
||||||
At this point, you can see `nginx` is running as a daemon.
|
At this point, you can see `nginx` is running as a daemon.
|
||||||
|
|
||||||
3. View just the container's ports.
|
3. View just the container's ports.
|
||||||
|
|
||||||
$ docker port web
|
$ docker port web
|
||||||
443/tcp -> 0.0.0.0:49156
|
443/tcp -> 0.0.0.0:49156
|
||||||
80/tcp -> 0.0.0.0:49157
|
80/tcp -> 0.0.0.0:49157
|
||||||
|
|
||||||
This tells you that the `web` container's port `80` is mapped to port
|
This tells you that the `web` container's port `80` is mapped to port
|
||||||
`49157` on your Docker host.
|
`49157` on your Docker host.
|
||||||
|
|
||||||
4. Enter the `http://localhost:49157` address (`localhost` is `0.0.0.0`) in your browser:
|
4. Enter the `http://localhost:49157` address (`localhost` is `0.0.0.0`) in your browser:
|
||||||
|
|
||||||
![Bad Address](/installation/images/bad_host.png)
|
![Bad Address](/installation/images/bad_host.png)
|
||||||
|
|
||||||
This didn't work. The reason it doesn't work is your `DOCKER_HOST` address is
|
This didn't work. The reason it doesn't work is your `DOCKER_HOST` address is
|
||||||
not the localhost address (0.0.0.0) but is instead the address of the
|
not the localhost address (0.0.0.0) but is instead the address of the
|
||||||
`boot2docker` VM.
|
`boot2docker` VM.
|
||||||
|
|
||||||
5. Get the address of the `boot2docker` VM.
|
5. Get the address of the `boot2docker` VM.
|
||||||
|
|
||||||
$ boot2docker ip
|
$ boot2docker ip
|
||||||
192.168.59.103
|
192.168.59.103
|
||||||
|
|
||||||
6. Enter the `http://192.168.59.103:49157` address in your browser:
|
6. Enter the `http://192.168.59.103:49157` address in your browser:
|
||||||
|
|
||||||
![Correct Addressing](/installation/images/good_host.png)
|
![Correct Addressing](/installation/images/good_host.png)
|
||||||
|
|
||||||
Success!
|
Success!
|
||||||
|
|
||||||
7. To stop and then remove your running `nginx` container, do the following:
|
7. To stop and then remove your running `nginx` container, do the following:
|
||||||
|
|
||||||
$ docker stop web
|
$ docker stop web
|
||||||
$ docker rm web
|
$ docker rm web
|
||||||
|
|
||||||
### Mount a volume on the container
|
### Mount a volume on the container
|
||||||
|
|
||||||
|
@ -231,46 +233,46 @@ The next exercise demonstrates how to do this.
|
||||||
|
|
||||||
1. Change to your user `$HOME` directory.
|
1. Change to your user `$HOME` directory.
|
||||||
|
|
||||||
$ cd $HOME
|
$ cd $HOME
|
||||||
|
|
||||||
2. Make a new `site` directory.
|
2. Make a new `site` directory.
|
||||||
|
|
||||||
$ mkdir site
|
$ mkdir site
|
||||||
|
|
||||||
3. Change into the `site` directory.
|
3. Change into the `site` directory.
|
||||||
|
|
||||||
$ cd site
|
$ cd site
|
||||||
|
|
||||||
4. Create a new `index.html` file.
|
4. Create a new `index.html` file.
|
||||||
|
|
||||||
$ echo "my new site" > index.html
|
$ echo "my new site" > index.html
|
||||||
|
|
||||||
5. Start a new `nginx` container and replace the `html` folder with your `site` directory.
|
5. Start a new `nginx` container and replace the `html` folder with your `site` directory.
|
||||||
|
|
||||||
$ docker run -d -P -v $HOME/site:/usr/share/nginx/html --name mysite nginx
|
$ docker run -d -P -v $HOME/site:/usr/share/nginx/html --name mysite nginx
|
||||||
|
|
||||||
6. Get the `mysite` container's port.
|
6. Get the `mysite` container's port.
|
||||||
|
|
||||||
$ docker port mysite
|
$ docker port mysite
|
||||||
80/tcp -> 0.0.0.0:49166
|
80/tcp -> 0.0.0.0:49166
|
||||||
443/tcp -> 0.0.0.0:49165
|
443/tcp -> 0.0.0.0:49165
|
||||||
|
|
||||||
7. Open the site in a browser:
|
7. Open the site in a browser:
|
||||||
|
|
||||||
![My site page](/installation/images/newsite_view.png)
|
![My site page](/installation/images/newsite_view.png)
|
||||||
|
|
||||||
8. Try adding a page to your `$HOME/site` in real time.
|
8. Try adding a page to your `$HOME/site` in real time.
|
||||||
|
|
||||||
$ echo "This is cool" > cool.html
|
$ echo "This is cool" > cool.html
|
||||||
|
|
||||||
9. Open the new page in the browser.
|
9. Open the new page in the browser.
|
||||||
|
|
||||||
![Cool page](/installation/images/cool_view.png)
|
![Cool page](/installation/images/cool_view.png)
|
||||||
|
|
||||||
9. Stop and then remove your running `mysite` container.
|
9. Stop and then remove your running `mysite` container.
|
||||||
|
|
||||||
$ docker stop mysite
|
$ docker stop mysite
|
||||||
$ docker rm mysite
|
$ docker rm mysite
|
||||||
|
|
||||||
## Upgrade Boot2Docker
|
## Upgrade Boot2Docker
|
||||||
|
|
||||||
|
@ -286,11 +288,11 @@ To upgrade from 1.4.1 or greater, you can do this:
|
||||||
|
|
||||||
2. Stop the `boot2docker` application.
|
2. Stop the `boot2docker` application.
|
||||||
|
|
||||||
$ boot2docker stop
|
$ boot2docker stop
|
||||||
|
|
||||||
3. Run the upgrade command.
|
3. Run the upgrade command.
|
||||||
|
|
||||||
$ boot2docker upgrade
|
$ boot2docker upgrade
|
||||||
|
|
||||||
|
|
||||||
### Use the installer
|
### Use the installer
|
||||||
|
@ -301,22 +303,46 @@ To upgrade any version of Boot2Docker, do this:
|
||||||
|
|
||||||
2. Stop the `boot2docker` application.
|
2. Stop the `boot2docker` application.
|
||||||
|
|
||||||
$ boot2docker stop
|
$ boot2docker stop
|
||||||
|
|
||||||
3. Go to the [boot2docker/osx-installer ](
|
3. Go to the [boot2docker/osx-installer ](
|
||||||
https://github.com/boot2docker/osx-installer/releases/latest) release page.
|
https://github.com/boot2docker/osx-installer/releases/latest) release page.
|
||||||
|
|
||||||
4. Download Boot2Docker by clicking `Boot2Docker-x.x.x.pkg` in the "Downloads"
|
4. Download Boot2Docker by clicking `Boot2Docker-x.x.x.pkg` in the "Downloads"
|
||||||
section.
|
section.
|
||||||
|
|
||||||
2. Install Boot2Docker by double-clicking the package.
|
2. Install Boot2Docker by double-clicking the package.
|
||||||
|
|
||||||
The installer places Boot2Docker in your "Applications" folder.
|
The installer places Boot2Docker in your "Applications" folder.
|
||||||
|
|
||||||
|
|
||||||
|
## Uninstallation
|
||||||
|
|
||||||
|
1. Go to the [boot2docker/osx-installer ](
|
||||||
|
https://github.com/boot2docker/osx-installer/releases/latest) release page.
|
||||||
|
|
||||||
|
2. Download the source code by clicking `Source code (zip)` or
|
||||||
|
`Source code (tar.gz)` in the "Downloads" section.
|
||||||
|
|
||||||
|
3. Extract the source code.
|
||||||
|
|
||||||
|
4. Open a terminal on your local machine.
|
||||||
|
|
||||||
|
5. Change to the directory where you extracted the source code:
|
||||||
|
|
||||||
|
$ cd <path to extracted source code>
|
||||||
|
|
||||||
|
6. Make sure the uninstall.sh script is executable:
|
||||||
|
|
||||||
|
$ chmod +x uninstall.sh
|
||||||
|
|
||||||
|
7. Run the uninstall.sh script:
|
||||||
|
|
||||||
|
$ ./uninstall.sh
|
||||||
|
|
||||||
|
|
||||||
## Learning more and acknowledgement
|
## Learning more and acknowledgement
|
||||||
|
|
||||||
|
|
||||||
Use `boot2docker help` to list the full command line reference. For more
|
Use `boot2docker help` to list the full command line reference. For more
|
||||||
information about using SSH or SCP to access the Boot2Docker VM, see the README
|
information about using SSH or SCP to access the Boot2Docker VM, see the README
|
||||||
at [Boot2Docker repository](https://github.com/boot2docker/boot2docker).
|
at [Boot2Docker repository](https://github.com/boot2docker/boot2docker).
|
||||||
|
|
|
@ -43,35 +43,35 @@ To enable the *addons* repository:
|
||||||
`/etc/yum.repos.d/public-yum-ol7.repo`
|
`/etc/yum.repos.d/public-yum-ol7.repo`
|
||||||
and set `enabled=1` in the `[ol6_addons]` or the `[ol7_addons]` stanza.
|
and set `enabled=1` in the `[ol6_addons]` or the `[ol7_addons]` stanza.
|
||||||
|
|
||||||
## To install Docker:
|
## Installation
|
||||||
|
|
||||||
1. Ensure the appropriate *addons* channel or repository has been enabled.
|
1. Ensure the appropriate *addons* channel or repository has been enabled.
|
||||||
|
|
||||||
2. Use yum to install the Docker package:
|
2. Use yum to install the Docker package:
|
||||||
|
|
||||||
$ sudo yum install docker
|
$ sudo yum install docker
|
||||||
|
|
||||||
## To start Docker:
|
## Starting Docker
|
||||||
|
|
||||||
1. Now that it's installed, start the Docker daemon:
|
1. Now that it's installed, start the Docker daemon:
|
||||||
|
|
||||||
1. On Oracle Linux 6:
|
1. On Oracle Linux 6:
|
||||||
|
|
||||||
$ sudo service docker start
|
$ sudo service docker start
|
||||||
|
|
||||||
2. On Oracle Linux 7:
|
2. On Oracle Linux 7:
|
||||||
|
|
||||||
$ sudo systemctl start docker.service
|
$ sudo systemctl start docker.service
|
||||||
|
|
||||||
2. If you want the Docker daemon to start automatically at boot:
|
2. If you want the Docker daemon to start automatically at boot:
|
||||||
|
|
||||||
1. On Oracle Linux 6:
|
1. On Oracle Linux 6:
|
||||||
|
|
||||||
$ sudo chkconfig docker on
|
$ sudo chkconfig docker on
|
||||||
|
|
||||||
2. On Oracle Linux 7:
|
2. On Oracle Linux 7:
|
||||||
|
|
||||||
$ sudo systemctl enable docker.service
|
$ sudo systemctl enable docker.service
|
||||||
|
|
||||||
**Done!**
|
**Done!**
|
||||||
|
|
||||||
|
@ -99,6 +99,20 @@ To enable btrfs support on Oracle Linux:
|
||||||
|
|
||||||
You can now continue with the [Docker User Guide](/userguide/).
|
You can now continue with the [Docker User Guide](/userguide/).
|
||||||
|
|
||||||
|
## Uninstallation
|
||||||
|
|
||||||
|
To uninstall the Docker package:
|
||||||
|
|
||||||
|
$ sudo yum -y remove docker
|
||||||
|
|
||||||
|
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:
|
||||||
|
|
||||||
|
$ rm -rf /var/lib/docker
|
||||||
|
|
||||||
|
You must delete the user created configuration files manually.
|
||||||
|
|
||||||
## Known issues
|
## Known issues
|
||||||
|
|
||||||
### Docker unmounts btrfs filesystem on shutdown
|
### Docker unmounts btrfs filesystem on shutdown
|
||||||
|
|
|
@ -16,7 +16,9 @@ running on kernels shipped by the distribution. There are kernel changes which
|
||||||
will cause issues if one decides to step outside that box and run
|
will cause issues if one decides to step outside that box and run
|
||||||
non-distribution kernel packages.
|
non-distribution kernel packages.
|
||||||
|
|
||||||
## Red Hat Enterprise Linux 7 installation
|
## Red Hat Enterprise Linux 7
|
||||||
|
|
||||||
|
### Installation
|
||||||
|
|
||||||
**Red Hat Enterprise Linux 7 (64 bit)** has [shipped with
|
**Red Hat Enterprise Linux 7 (64 bit)** has [shipped with
|
||||||
Docker](https://access.redhat.com/site/products/red-hat-enterprise-linux/docker-and-containers).
|
Docker](https://access.redhat.com/site/products/red-hat-enterprise-linux/docker-and-containers).
|
||||||
|
@ -41,7 +43,21 @@ Portal](https://access.redhat.com/).
|
||||||
|
|
||||||
Please continue with the [Starting the Docker daemon](#starting-the-docker-daemon).
|
Please continue with the [Starting the Docker daemon](#starting-the-docker-daemon).
|
||||||
|
|
||||||
## Red Hat Enterprise Linux 6.6 installation
|
### Uninstallation
|
||||||
|
|
||||||
|
To uninstall the Docker package:
|
||||||
|
|
||||||
|
$ sudo yum -y remove docker
|
||||||
|
|
||||||
|
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:
|
||||||
|
|
||||||
|
$ rm -rf /var/lib/docker
|
||||||
|
|
||||||
|
You must delete the user created configuration files manually.
|
||||||
|
|
||||||
|
## Red Hat Enterprise Linux 6.6
|
||||||
|
|
||||||
You will need **64 bit** [RHEL
|
You will need **64 bit** [RHEL
|
||||||
6.6](https://access.redhat.com/site/articles/3078#RHEL6) or later, with
|
6.6](https://access.redhat.com/site/articles/3078#RHEL6) or later, with
|
||||||
|
@ -66,7 +82,7 @@ non-distro kernel packages.
|
||||||
> vulnerabilities and severe bugs (such as those found in kernel 2.6.32)
|
> vulnerabilities and severe bugs (such as those found in kernel 2.6.32)
|
||||||
> are fixed.
|
> are fixed.
|
||||||
|
|
||||||
## Installation
|
### Installation
|
||||||
|
|
||||||
Firstly, you need to install the EPEL repository. Please follow the
|
Firstly, you need to install the EPEL repository. Please follow the
|
||||||
[EPEL installation
|
[EPEL installation
|
||||||
|
@ -90,6 +106,20 @@ To update the `docker-io` package
|
||||||
|
|
||||||
Please continue with the [Starting the Docker daemon](#starting-the-docker-daemon).
|
Please continue with the [Starting the Docker daemon](#starting-the-docker-daemon).
|
||||||
|
|
||||||
|
### Uninstallation
|
||||||
|
|
||||||
|
To uninstall the Docker package:
|
||||||
|
|
||||||
|
$ sudo yum -y remove docker-io
|
||||||
|
|
||||||
|
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:
|
||||||
|
|
||||||
|
$ rm -rf /var/lib/docker
|
||||||
|
|
||||||
|
You must delete the user created configuration files manually.
|
||||||
|
|
||||||
## Starting the Docker daemon
|
## Starting the Docker daemon
|
||||||
|
|
||||||
Now that it's installed, let's start the Docker daemon.
|
Now that it's installed, let's start the Docker daemon.
|
||||||
|
@ -118,7 +148,6 @@ 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
|
Docker runtime files, or make other customizations, read our Systemd article to
|
||||||
learn how to [customize your Systemd Docker daemon options](/articles/systemd/).
|
learn how to [customize your Systemd Docker daemon options](/articles/systemd/).
|
||||||
|
|
||||||
|
|
||||||
## Issues?
|
## Issues?
|
||||||
|
|
||||||
If you have any issues - please report them directly in the
|
If you have any issues - please report them directly in the
|
||||||
|
|
|
@ -28,8 +28,8 @@ and frequently panic under certain conditions.
|
||||||
To check your current kernel version, open a terminal and use `uname -r` to display
|
To check your current kernel version, open a terminal and use `uname -r` to display
|
||||||
your kernel version:
|
your kernel version:
|
||||||
|
|
||||||
$ uname -r
|
$ uname -r
|
||||||
3.11.0-15-generic
|
3.11.0-15-generic
|
||||||
|
|
||||||
>**Caution** Some Ubuntu OS versions **require a version higher than 3.10** to
|
>**Caution** Some Ubuntu OS versions **require a version higher than 3.10** to
|
||||||
>run Docker, see the prerequisites on this page that apply to your Ubuntu
|
>run Docker, see the prerequisites on this page that apply to your Ubuntu
|
||||||
|
@ -72,17 +72,17 @@ To upgrade your kernel and install the additional packages, do the following:
|
||||||
|
|
||||||
2. Update your package manager.
|
2. Update your package manager.
|
||||||
|
|
||||||
$ sudo apt-get update
|
$ sudo apt-get update
|
||||||
|
|
||||||
3. Install both the required and optional packages.
|
3. Install both the required and optional packages.
|
||||||
|
|
||||||
$ sudo apt-get install linux-image-generic-lts-trusty
|
$ sudo apt-get install linux-image-generic-lts-trusty
|
||||||
|
|
||||||
Depending on your environment, you may install more as described in the preceding table.
|
Depending on your environment, you may install more as described in the preceding table.
|
||||||
|
|
||||||
4. Reboot your host.
|
4. Reboot your host.
|
||||||
|
|
||||||
$ sudo reboot
|
$ sudo reboot
|
||||||
|
|
||||||
5. After your system reboots, go ahead and [install Docker](#installing-docker-on-ubuntu).
|
5. After your system reboots, go ahead and [install Docker](#installing-docker-on-ubuntu).
|
||||||
|
|
||||||
|
@ -92,7 +92,7 @@ To upgrade your kernel and install the additional packages, do the following:
|
||||||
Docker uses AUFS as the default storage backend. If you don't have this
|
Docker uses AUFS as the default storage backend. If you don't have this
|
||||||
prerequisite installed, Docker's installation process adds it.
|
prerequisite installed, Docker's installation process adds it.
|
||||||
|
|
||||||
##Installing Docker on Ubuntu
|
##Installation
|
||||||
|
|
||||||
Make sure you have installed the prerequisites for your Ubuntu version. Then,
|
Make sure you have installed the prerequisites for your Ubuntu version. Then,
|
||||||
install Docker using the following:
|
install Docker using the following:
|
||||||
|
@ -101,19 +101,19 @@ install Docker using the following:
|
||||||
|
|
||||||
2. Verify that you have `wget` installed.
|
2. Verify that you have `wget` installed.
|
||||||
|
|
||||||
$ which wget
|
$ which wget
|
||||||
|
|
||||||
If `wget` isn't installed, install it after updating your manager:
|
If `wget` isn't installed, install it after updating your manager:
|
||||||
|
|
||||||
$ sudo apt-get update
|
$ sudo apt-get update
|
||||||
$ sudo apt-get install wget
|
$ sudo apt-get install wget
|
||||||
|
|
||||||
3. Get the latest Docker package.
|
3. Get the latest Docker package.
|
||||||
|
|
||||||
$ wget -qO- https://get.docker.com/ | sh
|
$ wget -qO- https://get.docker.com/ | sh
|
||||||
|
|
||||||
The system prompts you for your `sudo` password. Then, it downloads and
|
The system prompts you for your `sudo` password. Then, it downloads and
|
||||||
installs Docker and its dependencies.
|
installs Docker and its dependencies.
|
||||||
>**Note**: If your company is behind a filtering proxy, you may find that the
|
>**Note**: If your company is behind a filtering proxy, you may find that the
|
||||||
>`apt-key`
|
>`apt-key`
|
||||||
>command fails for the Docker repo during installation. To work around this,
|
>command fails for the Docker repo during installation. To work around this,
|
||||||
|
@ -123,9 +123,9 @@ install Docker using the following:
|
||||||
|
|
||||||
4. Verify `docker` is installed correctly.
|
4. Verify `docker` is installed correctly.
|
||||||
|
|
||||||
$ sudo docker run hello-world
|
$ sudo docker run hello-world
|
||||||
|
|
||||||
This command downloads a test image and runs it in a container.
|
This command downloads a test image and runs it in a container.
|
||||||
|
|
||||||
## Optional configurations for Docker on Ubuntu
|
## Optional configurations for Docker on Ubuntu
|
||||||
|
|
||||||
|
@ -155,19 +155,19 @@ To create the `docker` group and add your user:
|
||||||
|
|
||||||
1. Log into Ubuntu as a user with `sudo` privileges.
|
1. Log into Ubuntu as a user with `sudo` privileges.
|
||||||
|
|
||||||
This procedure assumes you log in as the `ubuntu` user.
|
This procedure assumes you log in as the `ubuntu` user.
|
||||||
|
|
||||||
3. Create the `docker` group and add your user.
|
3. Create the `docker` group and add your user.
|
||||||
|
|
||||||
$ sudo usermod -aG docker ubuntu
|
$ sudo usermod -aG docker ubuntu
|
||||||
|
|
||||||
3. Log out and log back in.
|
3. Log out and log back in.
|
||||||
|
|
||||||
This ensures your user is running with the correct permissions.
|
This ensures your user is running with the correct permissions.
|
||||||
|
|
||||||
4. Verify your work by running `docker` without `sudo`.
|
4. Verify your work by running `docker` without `sudo`.
|
||||||
|
|
||||||
$ docker run hello-world
|
$ docker run hello-world
|
||||||
|
|
||||||
|
|
||||||
### Adjust memory and swap accounting
|
### Adjust memory and swap accounting
|
||||||
|
@ -187,13 +187,13 @@ following.
|
||||||
|
|
||||||
3. Set the `GRUB_CMDLINE_LINUX` value as follows:
|
3. Set the `GRUB_CMDLINE_LINUX` value as follows:
|
||||||
|
|
||||||
GRUB_CMDLINE_LINUX="cgroup_enable=memory swapaccount=1"
|
GRUB_CMDLINE_LINUX="cgroup_enable=memory swapaccount=1"
|
||||||
|
|
||||||
4. Save and close the file.
|
4. Save and close the file.
|
||||||
|
|
||||||
5. Update GRUB.
|
5. Update GRUB.
|
||||||
|
|
||||||
$ sudo update-grub
|
$ sudo update-grub
|
||||||
|
|
||||||
6. Reboot your system.
|
6. Reboot your system.
|
||||||
|
|
||||||
|
@ -216,25 +216,25 @@ To configure UFW and allow incoming connections on the Docker port:
|
||||||
|
|
||||||
2. Verify that UFW is installed and enabled.
|
2. Verify that UFW is installed and enabled.
|
||||||
|
|
||||||
$ sudo ufw status
|
$ sudo ufw status
|
||||||
|
|
||||||
3. Open the `/etc/default/ufw` file for editing.
|
3. Open the `/etc/default/ufw` file for editing.
|
||||||
|
|
||||||
$ sudo nano /etc/default/ufw
|
$ sudo nano /etc/default/ufw
|
||||||
|
|
||||||
4. Set the `DEFAULT_FORWARD_POLICY` policy to:
|
4. Set the `DEFAULT_FORWARD_POLICY` policy to:
|
||||||
|
|
||||||
DEFAULT_FORWARD_POLICY="ACCEPT"
|
DEFAULT_FORWARD_POLICY="ACCEPT"
|
||||||
|
|
||||||
5. Save and close the file.
|
5. Save and close the file.
|
||||||
|
|
||||||
6. Reload UFW to use the new setting.
|
6. Reload UFW to use the new setting.
|
||||||
|
|
||||||
$ sudo ufw reload
|
$ sudo ufw reload
|
||||||
|
|
||||||
7. Allow incoming connections on the Docker port.
|
7. Allow incoming connections on the Docker port.
|
||||||
|
|
||||||
$ sudo ufw allow 2375/tcp
|
$ sudo ufw allow 2375/tcp
|
||||||
|
|
||||||
### Configure a DNS server for use by Docker
|
### Configure a DNS server for use by Docker
|
||||||
|
|
||||||
|
@ -262,25 +262,25 @@ To specify a DNS server for use by Docker:
|
||||||
|
|
||||||
2. Open the `/etc/default/docker` file for editing.
|
2. Open the `/etc/default/docker` file for editing.
|
||||||
|
|
||||||
$ sudo nano /etc/default/docker
|
$ sudo nano /etc/default/docker
|
||||||
|
|
||||||
3. Add a setting for Docker.
|
3. Add a setting for Docker.
|
||||||
|
|
||||||
DOCKER_OPTS="--dns 8.8.8.8"
|
DOCKER_OPTS="--dns 8.8.8.8"
|
||||||
|
|
||||||
Replace `8.8.8.8` with a local DNS server such as `192.168.1.1`. You can also
|
Replace `8.8.8.8` with a local DNS server such as `192.168.1.1`. You can also
|
||||||
specify multiple DNS servers. Separated them with spaces, for example:
|
specify multiple DNS servers. Separated them with spaces, for example:
|
||||||
|
|
||||||
--dns 8.8.8.8 --dns 192.168.1.1
|
--dns 8.8.8.8 --dns 192.168.1.1
|
||||||
|
|
||||||
>**Warning**: If you're doing this on a laptop which connects to various
|
>**Warning**: If you're doing this on a laptop which connects to various
|
||||||
>networks, make sure to choose a public DNS server.
|
>networks, make sure to choose a public DNS server.
|
||||||
|
|
||||||
4. Save and close the file.
|
4. Save and close the file.
|
||||||
|
|
||||||
5. Restart the Docker daemon.
|
5. Restart the Docker daemon.
|
||||||
|
|
||||||
$ sudo restart docker
|
$ sudo restart docker
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
@ -291,22 +291,39 @@ NetworkManager (this might slow your network).
|
||||||
|
|
||||||
1. Open the `/etc/NetworkManager/NetworkManager.conf` file for editing.
|
1. Open the `/etc/NetworkManager/NetworkManager.conf` file for editing.
|
||||||
|
|
||||||
$ sudo nano /etc/NetworkManager/NetworkManager.conf
|
$ sudo nano /etc/NetworkManager/NetworkManager.conf
|
||||||
|
|
||||||
2. Comment out the `dns=dsnmasq` line:
|
2. Comment out the `dns=dsnmasq` line:
|
||||||
|
|
||||||
dns=dnsmasq
|
dns=dnsmasq
|
||||||
|
|
||||||
3. Save and close the file.
|
3. Save and close the file.
|
||||||
|
|
||||||
4. Restart both the NetworkManager and Docker.
|
4. Restart both the NetworkManager and Docker.
|
||||||
|
|
||||||
$ sudo restart network-manager $ sudo restart docker
|
$ sudo restart network-manager $ sudo restart docker
|
||||||
|
|
||||||
|
|
||||||
## Upgrade Docker
|
## Upgrade Docker
|
||||||
|
|
||||||
To install the latest version of Docker, use the standard `-N` flag with `wget`:
|
To install the latest version of Docker with `wget`:
|
||||||
|
|
||||||
$ wget -qO- https://get.docker.com/ | sh
|
$ wget -qO- https://get.docker.com/ | sh
|
||||||
|
|
||||||
|
## Uninstallation
|
||||||
|
|
||||||
|
To uninstall the Docker package:
|
||||||
|
|
||||||
|
$ sudo apt-get purge lxc-docker
|
||||||
|
|
||||||
|
To uninstall the Docker package and dependencies that are no longer needed:
|
||||||
|
|
||||||
|
$ sudo apt-get autoremove --purge lxc-docker
|
||||||
|
|
||||||
|
The above commands 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:
|
||||||
|
|
||||||
|
$ rm -rf /var/lib/docker
|
||||||
|
|
||||||
|
You must delete the user created configuration files manually.
|
||||||
|
|
|
@ -67,7 +67,7 @@ Boot2Docker command requires `ssh.exe` to be in the PATH, therefore we need to
|
||||||
include `bin` folder of the Git installation (which has ssh.exe) to the `%PATH%`
|
include `bin` folder of the Git installation (which has ssh.exe) to the `%PATH%`
|
||||||
environment variable by running:
|
environment variable by running:
|
||||||
|
|
||||||
set PATH=%PATH%;"c:\Program Files (x86)\Git\bin"
|
set PATH=%PATH%;"c:\Program Files (x86)\Git\bin"
|
||||||
|
|
||||||
and then we can run the `boot2docker start` command to start the Boot2Docker VM.
|
and then we can run the `boot2docker start` command to start the Boot2Docker VM.
|
||||||
(Run `boot2docker init` command if you get an error saying machine does not
|
(Run `boot2docker init` command if you get an error saying machine does not
|
||||||
|
@ -81,7 +81,7 @@ to your console window and you are ready to run docker commands such as
|
||||||
|
|
||||||
Launch a PowerShell window, then you need to add `ssh.exe` to your PATH:
|
Launch a PowerShell window, then you need to add `ssh.exe` to your PATH:
|
||||||
|
|
||||||
$Env:Path = "${Env:Path};c:\Program Files (x86)\Git\bin"
|
$Env:Path = "${Env:Path};c:\Program Files (x86)\Git\bin"
|
||||||
|
|
||||||
and after running `boot2docker start` command it will print PowerShell commands
|
and after running `boot2docker start` command it will print PowerShell commands
|
||||||
to set the environment variables to connect Docker running inside VM. Run these
|
to set the environment variables to connect Docker running inside VM. Run these
|
||||||
|
@ -150,6 +150,12 @@ You can do this with
|
||||||
- then click: "Save Private Key".
|
- then click: "Save Private Key".
|
||||||
- Then use the saved file to login with PuTTY using `docker@127.0.0.1:2022`.
|
- Then use the saved file to login with PuTTY using `docker@127.0.0.1:2022`.
|
||||||
|
|
||||||
|
## Uninstallation
|
||||||
|
|
||||||
|
You can uninstall Boot2Docker using Window's standard process for removing programs.
|
||||||
|
This process does not remove the `docker-install.exe` file. You must delete that file
|
||||||
|
yourself.
|
||||||
|
|
||||||
## References
|
## References
|
||||||
|
|
||||||
If you have Docker hosts running and if you don't wish to do a
|
If you have Docker hosts running and if you don't wish to do a
|
||||||
|
|
Loading…
Reference in a new issue