Skip to content

Commit 58f0803

Browse files
engine/install: add note for service start on deb flavors (#23405)
## Description This change is to address some feedback from a Ubuntu user that installed Docker Engine using the apt repository but had to start the service before they were able to run containers. While autostart is the convention on Debian systems, some users might have this behavior disabled for more fine grained control. This change adds a note to the installation step across all the debian flavors to note the service should start by default with explicit instructions how to enable the service if not. ## Related issues or tickets <!-- Related issues, pull requests, or Jira tickets --> ## Reviews <!-- Notes for reviewers here --> <!-- List applicable reviews (optionally @tag reviewers) --> - [ ] Technical review - @vvoland - [ ] Editorial review - @usha-mandya - [ ] Product review Signed-off-by: Austin Vazquez <[email protected]>
1 parent af160be commit 58f0803

File tree

3 files changed

+87
-6
lines changed

3 files changed

+87
-6
lines changed

content/manuals/engine/install/debian.md

Lines changed: 29 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -173,6 +173,21 @@ Docker from the repository.
173173
{{< /tab >}}
174174
{{< /tabs >}}
175175

176+
> [!NOTE]
177+
>
178+
> The Docker service starts automatically after installation. To verify that
179+
> Docker is running, use:
180+
>
181+
> ```console
182+
> $ sudo systemctl status docker
183+
> ```
184+
>
185+
> Some systems may have this behavior disabled and will require a manual start:
186+
>
187+
> ```console
188+
> $ sudo systemctl start docker
189+
> ```
190+
176191
3. Verify that the installation is successful by running the `hello-world` image:
177192
178193
```console
@@ -226,12 +241,24 @@ download a new file each time you want to upgrade Docker Engine.
226241
./docker-compose-plugin_<version>_<arch>.deb
227242
```
228243

229-
The Docker daemon starts automatically.
244+
> [!NOTE]
245+
>
246+
> The Docker service starts automatically after installation. To verify that
247+
> Docker is running, use:
248+
>
249+
> ```console
250+
> $ sudo systemctl status docker
251+
> ```
252+
>
253+
> Some systems may have this behavior disabled and will require a manual start:
254+
>
255+
> ```console
256+
> $ sudo systemctl start docker
257+
> ```
230258
231259
6. Verify that the installation is successful by running the `hello-world` image:
232260
233261
```console
234-
$ sudo service docker start
235262
$ sudo docker run hello-world
236263
```
237264

content/manuals/engine/install/raspberry-pi-os.md

Lines changed: 29 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -160,6 +160,21 @@ Docker from the repository.
160160
{{< /tab >}}
161161
{{< /tabs >}}
162162

163+
> [!NOTE]
164+
>
165+
> The Docker service starts automatically after installation. To verify that
166+
> Docker is running, use:
167+
>
168+
> ```console
169+
> $ sudo systemctl status docker
170+
> ```
171+
>
172+
> Some systems may have this behavior disabled and will require a manual start:
173+
>
174+
> ```console
175+
> $ sudo systemctl start docker
176+
> ```
177+
163178
3. Verify that the installation is successful by running the `hello-world` image:
164179
165180
```console
@@ -213,12 +228,24 @@ download a new file each time you want to upgrade Docker Engine.
213228
./docker-compose-plugin_<version>_<arch>.deb
214229
```
215230

216-
The Docker daemon starts automatically.
231+
> [!NOTE]
232+
>
233+
> The Docker service starts automatically after installation. To verify that
234+
> Docker is running, use:
235+
>
236+
> ```console
237+
> $ sudo systemctl status docker
238+
> ```
239+
>
240+
> Some systems may have this behavior disabled and will require a manual start:
241+
>
242+
> ```console
243+
> $ sudo systemctl start docker
244+
> ```
217245
218246
6. Verify that the installation is successful by running the `hello-world` image:
219247
220248
```console
221-
$ sudo service docker start
222249
$ sudo docker run hello-world
223250
```
224251

content/manuals/engine/install/ubuntu.md

Lines changed: 29 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -175,6 +175,21 @@ Docker from the repository.
175175
{{< /tab >}}
176176
{{< /tabs >}}
177177

178+
> [!NOTE]
179+
>
180+
> The Docker service starts automatically after installation. To verify that
181+
> Docker is running, use:
182+
>
183+
> ```console
184+
> $ sudo systemctl status docker
185+
> ```
186+
>
187+
> Some systems may have this behavior disabled and will require a manual start:
188+
>
189+
> ```console
190+
> $ sudo systemctl start docker
191+
> ```
192+
178193
3. Verify that the installation is successful by running the `hello-world` image:
179194
180195
```console
@@ -228,12 +243,24 @@ download a new file each time you want to upgrade Docker Engine.
228243
./docker-compose-plugin_<version>_<arch>.deb
229244
```
230245

231-
The Docker daemon starts automatically.
246+
> [!NOTE]
247+
>
248+
> The Docker service starts automatically after installation. To verify that
249+
> Docker is running, use:
250+
>
251+
> ```console
252+
> $ sudo systemctl status docker
253+
> ```
254+
>
255+
> Some systems may have this behavior disabled and will require a manual start:
256+
>
257+
> ```console
258+
> $ sudo systemctl start docker
259+
> ```
232260
233261
6. Verify that the installation is successful by running the `hello-world` image:
234262
235263
```console
236-
$ sudo service docker start
237264
$ sudo docker run hello-world
238265
```
239266

0 commit comments

Comments
 (0)