1
0
Fork 0
mirror of https://github.com/moby/moby.git synced 2022-11-09 12:21:53 -05:00

Update with @moxiegirl's patch and add direct config

Signed-off-by: Ankush Agarwal <ankushagarwal11@gmail.com>
This commit is contained in:
Ankush Agarwal 2015-04-22 10:35:58 -07:00
parent 9424fc14bb
commit 9689aab5ec

View file

@ -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