You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/FAQ.md
+58Lines changed: 58 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -228,3 +228,61 @@ Portainer has many issues which make it hard for us to support, such as:
228
228
- No automatically created custom networks for inter-container communication
229
229
- Inconsistent compose implementations on different architectures
230
230
- Incorrectly applying environment variables on container upgrades
231
+
232
+
## Inexplicable issues when running ubuntu {#snap}
233
+
234
+
Many users have been facing issues that are simply inexplicable. The logs show no problems, the compose is fine, eventually it turns out they've installed the SNAP version of docker which is the source of the issues.
235
+
236
+
### Symptoms
237
+
238
+
It's difficult to identify the symptoms, but if you are running ubuntu and believe you have done everything correctly, check for SNAP docker.
239
+
240
+
### Resolution
241
+
242
+
First the user must be on an appropriate version of ubuntu to face this issue (as far as I am aware)
243
+
244
+
`lsb_release -a`would result in something similar to the below output
245
+
```bash
246
+
No LSB modules are available.
247
+
Distributor ID: Ubuntu
248
+
Description: Ubuntu 22.04.3 LTS
249
+
Release: 22.04
250
+
Codename: jammy
251
+
```
252
+
253
+
`snap list | grep docker`would result in something similar to the below output
254
+
```bash
255
+
docker 20.10.24 2904 latest/stable canonical** -
256
+
```
257
+
258
+
This means the snap version of docker is installed. Unfortunately, even if the user installed docker from the proper repo, this snap version will coexist AND be preferred. They will need to remove it, as shown below.
2023-11-15T01:06:26Z INFO Waiting for "snap.docker.dockerd.service" to stop.
264
+
docker removed
265
+
oliver@home-server:~/plexDockerImage$
266
+
```
267
+
268
+
Following this, confirm nothing related to snap still shows.
269
+
```bash
270
+
~$ sudo whereis docker
271
+
docker: /usr/libexec/docker
272
+
```
273
+
above is what we might want to see, below is how it would look if both official AND snap are installed. Seeing the snap stuff removed but the official there is OK.
As you can see in the second one, multiple versions can coexist which is a big tshoot problem.
280
+
281
+
Once this is complete, if the expected version isn't present, simply follow [docker install on ubuntu](https://docs.docker.com/engine/install/ubuntu/)
282
+
283
+
When they finish, running `docker` commands may result in `-bash: /snap/bin/docker: No such file or directory` if this is the case, this is simply a shell patch issue, they can launch a new shell or simply input `hash -r` which should resolve the problem. Version info at the time of this writing should be
0 commit comments