Stopping a Docker Container: A Step-by-Step Guide


Docker has become an essential tool for developers, enabling them to create, deploy, and manage applications within containers. These containers are lightweight, portable, and consistent, making it easier to streamline development workflows.

However, there will be times when you need to stop a running Docker container, either for maintenance, updates, or to troubleshoot issues. In this article, we’ll explore the process of stopping a Docker container, using simple commands and best practices.

Step 1: List Running Containers

Before you can stop a Docker container, you need to identify which container you want to stop. To do this, use the ‘docker ps’ command, which lists all running containers, along with essential information such as container ID, image, command, creation time, status, and ports.

$ docker ps

Step 2: Identify the Container to Stop

When you execute the ‘docker ps’ command, you will see a list of running containers. To stop a specific container, you will need its container ID or name. The container ID is a unique, alphanumeric string associated with each container.

The container name is a human-readable identifier that can be assigned during container creation using the ‘–name’ flag. If a name is not provided, Docker will automatically generate a random one.

Step 3: Stopping the Container

Once you have identified the container you want to stop, use the ‘docker stop’ command, followed by the container ID or name. This command sends a SIGTERM signal to the container, allowing it to perform a graceful shutdown before being terminated.

$ docker stop <container_id_or_name>

For example, if you have a container with the ID ‘abcdef123456’ or the name ‘my-container’, you can stop it using either of these commands:

$ docker stop abcdef123456
$ docker stop my-container

The ‘docker stop’ command returns the container ID or name when it is successfully stopped.

Step 4: Confirm the Container is Stopped

To verify that the container has been stopped, you can use the ‘docker ps’ command again. This time, the stopped container should not appear in the list of running containers. If you want to view all containers, including stopped ones, use the ‘-a’ or ‘–all’ flag:

$ docker ps -a

If the container is still running after attempting to stop it, you can try forcing the container to stop using the ‘–force’ or ‘-f’ flag with the ‘docker stop’ command:

$ docker stop --force <container_id_or_name>

This command sends a SIGKILL signal to the container, forcibly terminating it without allowing it to perform a graceful shutdown. Be cautious when using this command, as it may cause data loss or corruption.


Stopping a Docker container is a simple and straightforward process, involving just a few commands. By understanding how to list, identify, and stop containers, you can effectively manage your Docker environments and maintain a smooth development workflow. Always remember to use the ‘–force’ flag with caution, as it can lead to unintended consequences.

Related Articles