Skip to content

Commit 6531a76

Browse files
committed
engine/install: enable engine as system service on rpm installs
Unlike deb-based systems, installing an rpm doesn't automatically start the Docker service, and starting the service doesn't make it automatically start on (re)boot. Update the instructions so that Docker is automatically started on boot. Signed-off-by: Sebastiaan van Stijn <[email protected]>
1 parent 9eeb171 commit 6531a76

File tree

4 files changed

+64
-22
lines changed

4 files changed

+64
-22
lines changed

content/manuals/engine/install/centos.md

Lines changed: 16 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -142,12 +142,18 @@ $ sudo yum-config-manager --add-repo {{% param "download-url-base" %}}/docker-ce
142142
{{< /tab >}}
143143
{{< /tabs >}}
144144

145-
2. Start Docker.
145+
2. Start Docker Engine.
146+
147+
Start the Docker Engine and containerd as a systemd service that will launch
148+
on boot:
146149

147150
```console
148-
$ sudo systemctl start docker
151+
$ sudo systemctl enable --now containerd docker
149152
```
150153

154+
If you prefer Docker to only start manually, use `sudo systemctl start docker`
155+
instead, which runs it only for the current session.
156+
151157
3. Verify that the Docker Engine installation is successful by running the
152158
`hello-world` image.
153159

@@ -188,12 +194,18 @@ download a new file each time you want to upgrade Docker Engine.
188194
Docker is installed but not started. The `docker` group is created, but no
189195
users are added to the group.
190196

191-
3. Start Docker.
197+
3. Start Docker Engine.
198+
199+
Start the Docker Engine and containerd as a systemd service that will launch
200+
on boot:
192201

193202
```console
194-
$ sudo systemctl start docker
203+
$ sudo systemctl enable --now containerd docker
195204
```
196205

206+
If you prefer Docker to only start manually, use `sudo systemctl start docker`
207+
instead, which runs it only for the current session.
208+
197209
4. Verify that the Docker Engine installation is successful by running the
198210
`hello-world` image.
199211

content/manuals/engine/install/fedora.md

Lines changed: 16 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -139,12 +139,18 @@ $ sudo dnf-3 config-manager --add-repo {{% param "download-url-base" %}}/docker-
139139
{{< /tab >}}
140140
{{< /tabs >}}
141141

142-
2. Start Docker.
142+
2. Start Docker Engine.
143+
144+
Start the Docker Engine and containerd as a systemd service that will launch
145+
on boot:
143146

144147
```console
145-
$ sudo systemctl start docker
148+
$ sudo systemctl enable --now containerd docker
146149
```
147150

151+
If you prefer Docker to only start manually, use `sudo systemctl start docker`
152+
instead, which runs it only for the current session.
153+
148154
3. Verify that the Docker Engine installation is successful by running the
149155
`hello-world` image.
150156

@@ -185,19 +191,19 @@ download a new file each time you want to upgrade Docker Engine.
185191
Docker is installed but not started. The `docker` group is created, but no
186192
users are added to the group.
187193

188-
3. Start Docker.
189-
190-
```console
191-
$ sudo systemctl start docker
192-
```
194+
3. Start Docker Engine.
193195

194-
4. Make Docker start automatically after reboot.
196+
Start the Docker Engine and containerd as a systemd service that will launch
197+
on boot:
195198

196199
```console
197-
$ sudo systemctl enable docker
200+
$ sudo systemctl enable --now containerd docker
198201
```
199202

200-
5. Verify that the Docker Engine installation is successful by running the
203+
If you prefer Docker to only start manually, use `sudo systemctl start docker`
204+
instead, which runs it only for the current session.
205+
206+
4. Verify that the Docker Engine installation is successful by running the
201207
`hello-world` image.
202208

203209
```console

content/manuals/engine/install/rhel.md

Lines changed: 16 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -143,12 +143,18 @@ $ sudo yum-config-manager --add-repo {{% param "download-url-base" %}}/docker-ce
143143
{{< /tab >}}
144144
{{< /tabs >}}
145145

146-
2. Start Docker.
146+
2. Start Docker Engine.
147+
148+
Start the Docker Engine and containerd as a systemd service that will launch
149+
on boot:
147150

148151
```console
149-
$ sudo systemctl start docker
152+
$ sudo systemctl enable --now containerd docker
150153
```
151154

155+
If you prefer Docker to only start manually, use `sudo systemctl start docker`
156+
instead, which runs it only for the current session.
157+
152158
3. Verify that the Docker Engine installation is successful by running the
153159
`hello-world` image.
154160

@@ -205,12 +211,18 @@ download a new file each time you want to upgrade Docker Engine.
205211
Docker is installed but not started. The `docker` group is created, but no
206212
users are added to the group.
207213

208-
6. Start Docker.
214+
6. Start Docker Engine.
215+
216+
Start the Docker Engine and containerd as a systemd service that will launch
217+
on boot:
209218

210219
```console
211-
$ sudo systemctl start docker
220+
$ sudo systemctl enable --now containerd docker
212221
```
213222

223+
If you prefer Docker to only start manually, use `sudo systemctl start docker`
224+
instead, which runs it only for the current session.
225+
214226
7. Verify that the Docker Engine installation is successful by running the
215227
`hello-world` image.
216228

content/manuals/engine/install/sles.md

Lines changed: 16 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -162,12 +162,18 @@ $ sudo zypper addrepo {{% param "download-url-base" %}}/docker-ce.repo
162162
{{< /tab >}}
163163
{{< /tabs >}}
164164

165-
2. Start Docker.
165+
2. Start Docker Engine.
166+
167+
Start the Docker Engine and containerd as a systemd service that will launch
168+
on boot:
166169

167170
```console
168-
$ sudo systemctl start docker
171+
$ sudo systemctl enable --now containerd docker
169172
```
170173

174+
If you prefer Docker to only start manually, use `sudo systemctl start docker`
175+
instead, which runs it only for the current session.
176+
171177
3. Verify that the Docker Engine installation is successful by running the
172178
`hello-world` image.
173179

@@ -208,12 +214,18 @@ download a new file each time you want to upgrade Docker Engine.
208214
Docker is installed but not started. The `docker` group is created, but no
209215
users are added to the group.
210216

211-
3. Start Docker.
217+
3. Start Docker Engine.
218+
219+
Start the Docker Engine and containerd as a systemd service that will launch
220+
on boot:
212221

213222
```console
214-
$ sudo systemctl start docker
223+
$ sudo systemctl enable --now containerd docker
215224
```
216225

226+
If you prefer Docker to only start manually, use `sudo systemctl start docker`
227+
instead, which runs it only for the current session.
228+
217229
4. Verify that the Docker Engine installation is successful by running the
218230
`hello-world` image.
219231

0 commit comments

Comments
 (0)