Docker Docker Troubleshooting Common Error Messages port already allocated container already in use no space left on device layer already exists

1. Core Command / Concept

Docker container management and troubleshooting. docker ps -a.

2. Step‑by‑Step

1. Check if a port is already allocated:
   ⚠️ Run docker ps -a to list all containers.
   ⚠️ Check the CONTAINER ID and NAMES of the container using the port.
   ⚠️ Run docker inspect to check the port mapping.
2. Check if a container is already in use:
   ⚠️ Run docker ps -a to list all containers.
   ⚠️ Check the STATUS of the container.
   ⚠️ Run docker stop to stop the container.
3. Check if there is no space left on the device:
   ⚠️ Run df -h to check the disk usage.
   ⚠️ Run docker system df to check Docker disk usage.
   ⚠️ Run docker system prune -af to clean up unused Docker data.
4. Check if a layer already exists:
   ⚠️ Run docker images to list all images.
   ⚠️ Check the REPOSITORY and TAG of the image.
   ⚠️ Run docker rmi to remove the image.

3. Real Commands with Examples

1. Purpose: Check if a port is already allocated.
   Command: docker ps -a
   Brief explanation of flags: -a lists all containers, including stopped ones.
2. Purpose: Remove a stopped container.
   Command: docker rm -f
   Brief explanation of flags: -f forces the removal of the container.
3. Purpose: Remove an unused image.
   Command: docker rmi
   Brief explanation of flags: None.

4. Common Errors

1. Error message or symptom: "port already allocated"
   Why it happens: Another container is using the port.
   One-line fix: docker stop to stop the container.
2. Error message or symptom: "container already in use"
   Why it happens: The container is running and cannot be deleted.
   One-line fix: docker stop to stop the container.
3. Error message or symptom: "no space left on device"
   Why it happens: The disk is full and Docker cannot create new data.
   One-line fix: docker system prune -af to clean up unused Docker data.
4. Error message or symptom: "layer already exists"
   Why it happens: The image is already downloaded.
   One-line fix: docker rmi to remove the image.

5. Quick Checks

1. Situation: A container is running but not responding.
   Command to run: docker logs
   What a correct response looks like: The container logs.
2. Situation: A container is taking up too much disk space.
   Command to run: docker system df
   What a correct response looks like: The Docker disk usage.
3. Situation: A container is not starting.
   Command to run: docker logs
   What a correct response looks like: The container logs.

6. Last‑Minute Reference

• docker ps -a lists all containers.
• docker stop stops a container.
• docker rm -f removes a stopped container.
• docker rmi removes an unused image.
• docker system prune -af cleans up unused Docker data.
• docker system df checks Docker disk usage.
• docker inspect checks container details.
• docker logs checks container logs.
• docker version checks Docker version.
• ⚠️ docker rm -f deletes all stopped containers.