diff --git a/docs/sources/articles/configuring.md b/docs/sources/articles/configuring.md index 5fae38c5bc..35d0eb8e58 100644 --- a/docs/sources/articles/configuring.md +++ b/docs/sources/articles/configuring.md @@ -4,27 +4,46 @@ page_keywords: docker, daemon, configuration # Configuring Docker on various distributions -After successfully installing the Docker daemon on a distribution, it runs with it's default -config. Usually it is required to change the default config to meet one's personal requirements. - -Docker can be configured by passing the config flags to the daemon directly if the daemon -is started directly. Usually that is not the case. A process manager (like SysVinit, Upstart, -systemd, etc) is responsible for starting and running the daemon. +After successfully installing Docker, the `docker` daemon runs with it's default +configuration. You can configure the `docker` daemon by passing configuration +flags to it directly when you start it. -Some common config options are +In a production environment, system administrators typically configure the +`docker` daemon to start and stop according to an organization's requirements. In most +cases, the system administrator configures a process manager such as `SysVinit`, `Upstart`, +or `systemd` to manage the `docker` daemon's start and stop. -* `-D` : Enable debug mode +Some of the daemon's options are: -* `-H` : Daemon socket(s) to connect to +| Flag | Description | +|-----------------------|-----------------------------------------------------------| +| `-D`, `--debug=false` | Enable or disable debug mode. By default, this is false. | +| `-H`,`--host=[]` | Daemon socket(s) to connect to. | +| `--tls=false` | Enable or disable TLS. By default, this is false. | -* `--tls` : Enable or disable TLS authentication +The command line reference has the [complete list of daemon flags](/reference/commandline/cli/#daemon). + +## Direct Configuration + +If you're running the `docker` daemon directly by running `docker -d` instead of using a process manager, +you can append the config options to the run command directly. + + +Here is a an example of running the `docker` daemon with config options: + + docker -d -D --tls=false -H tcp://0.0.0.0:2375 + +These options : + +- Enable `-D` (debug) mode +- Set `tls` to false +- Listen for connections on `tcp://0.0.0.0:2375` -The complete list of flags can found at [Docker Command Line Reference](/reference/commandline/cli/) ## Ubuntu After successfully [installing Docker for Ubuntu](/installation/ubuntulinux/), you can check the -running status using (if running Upstart) +running status using Upstart in this way: $ sudo status docker docker start/running, process 989 @@ -40,21 +59,40 @@ You can start/stop/restart `docker` using ### Configuring Docker -Docker options can be configured by editing the file `/etc/default/docker`. If this file does not -exist, it needs to be createdThis file contains a variable named `DOCKER_OPTS`. All the -config options need to be placed in this variable. For example +You configure the `docker` daemon in the `/etc/default/docker` file on your +system. You do this by specifying values in a `DOCKER_OPTS` variable. +To configure Docker options: - DOCKER_OPTS=" --dns 8.8.8.8 -D --tls=false -H tcp://0.0.0.0:2375 " +1. Log into your system as a user with `sudo` or `root` privileges. -The above daemon options : +2. If you don't have one, create the `/etc/default/docker` file in your system. -1. Set dns server for all containers + Depending on how you installed Docker, you may already have this file. -2. Enable Debug mode +3. Open the file with your favorite editor. -3. Set tls to false + $ sudo vi /etc/default/docker + +4. Add a `DOCKER_OPTS` variable with the following options. These options are appended to the +`docker` daemon's run command. -4. Make the daemon listen for connections on `tcp://0.0.0.0:2375` + ``` + DOCKER_OPTS=" --dns 8.8.8.8 --dns 8.8.4.4 -D --tls=false -H tcp://0.0.0.0:2375 " + ``` + +These options : -After saving the file, restart docker using `sudo restart docker`. Verify that the daemon is -running with the options specified by running `ps aux | grep docker | grep -v grep` +- Set `dns` server for all containers +- Enable `-D` (debug) mode +- Set `tls` to false +- Listen for connections on `tcp://0.0.0.0:2375` + +5. Save and close the file. + +6. Restart the `docker` daemon. + + $ sudo restart docker + +7. Verify that the `docker` daemon is running as specified wit the `ps` command. + + $ ps aux | grep docker | grep -v grep