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:
parent
9424fc14bb
commit
9689aab5ec
1 changed files with 61 additions and 23 deletions
|
@ -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
|
||||
|
|
Loading…
Add table
Reference in a new issue