Extract the systemd docs from various places and add a little more

Signed-off-by: Sven Dowideit <SvenDowideit@docker.com>
2026-10-03 23:38:24 +00:00 · 2014-11-27 10:17:46 +10:00
parent 9974fce28a
commit d53b586ff1
10 changed files with 153 additions and 25 deletions
@@ -0,0 +1,101 @@
+page_title: Controlling and configuring Docker using Systemd
+page_description: Controlling and configuring Docker using Systemd
+page_keywords: docker, daemon, systemd, configuration
+
+# Controlling and configuring Docker using Systemd
+
+Many Linux distributions use systemd to start the Docker daemon. This document
+shows a few examples of how to customise Docker's settings.
+
+## Starting the Docker daemon
+
+Once Docker is installed, you will need to start the Docker daemon.
+
+    $ sudo systemctl start docker
+    # or on older distributions, you may need to use
+    $ sudo service docker start
+
+If you want Docker to start at boot, you should also:
+
+    $ sudo systemctl enable docker
+    # or on older distributions, you may need to use
+    $ sudo chkconfig docker on
+
+## Custom Docker daemon options
+
+There are a number of ways to configure the daemon flags and environment variables
+for your Docker daemon. 
+
+If the `docker.service` file is set to use an `EnvironmentFile`
+(often pointing to `/etc/sysconfig/docker`) then you can modify the
+referenced file.
+
+Or, you may need to edit the `docker.service` file, which can be in `/usr/lib/systemd/system`
+or `/etc/systemd/service`.
+
+### Runtime directory and storage driver
+
+You may want to control the disk space used for Docker images, containers
+and volumes by moving it to a separate partition.
+
+In this example, we'll assume that your `docker.services` file looks something like:
+
+    [Unit]
+    Description=Docker Application Container Engine
+    Documentation=http://docs.docker.com
+    After=network.target docker.socket
+    Requires=docker.socket
+    
+    [Service]
+    Type=notify
+    EnvironmentFile=-/etc/sysconfig/docker
+    ExecStart=/usr/bin/docker -d -H fd:// $OPTIONS
+    LimitNOFILE=1048576
+    LimitNPROC=1048576
+    
+    [Install]
+    Also=docker.socket
+
+This will allow us to add extra flags to the `/etc/sysconfig/docker` file by
+setting `OPTIONS`:
+
+    OPTIONS="--graph /mnt/docker-data --storage btrfs"
+
+You can also set other environment variables in this file, for example, the
+`HTTP_PROXY` environment variables described below.
+
+### HTTP Proxy
+
+This example overrides the default `docker.service` file.
+
+If you are behind a HTTP proxy server, for example in corporate settings, 
+you will need to add this configuration in the Docker systemd service file.
+
+Copy file `/usr/lib/systemd/system/docker.service` to `/etc/systemd/system/docker/service`.
+
+Add the following to the `[Service]` section in the new file:
+
+    Environment="HTTP_PROXY=http://proxy.example.com:80/"
+
+If you have internal Docker registries that you need to contact without
+proxying you can specify them via the `NO_PROXY` environment variable:
+
+    Environment="HTTP_PROXY=http://proxy.example.com:80/" "NO_PROXY=localhost,127.0.0.0/8,docker-registry.somecorporation.com"
+
+Flush changes:
+
+    $ sudo systemctl daemon-reload
+    
+Restart Docker:
+
+    $ sudo systemctl restart docker
+
+## Manually creating the systemd unit files
+
+When installing the binary without a package, you may want
+to integrate Docker with systemd. For this, simply install the two unit files
+(service and socket) from [the github
+repository](https://github.com/docker/docker/tree/master/contrib/init/systemd)
+to `/etc/systemd/system`.
+
+