KAHIBARO Bookshelves
Discord Login Register

4.5. Listing Containers

Seeing What Is Running

Before you can manage containers, you need to know which ones exist on your system and which ones are currently running. Docker provides a small set of commands to list containers in different states, and to adjust how much information you see.

Listing Running Containers

The main command to see running containers is:

docker ps

This shows only containers that are currently running. The output is a table with several columns. For example:

CONTAINER ID shows a short identifier you can use in other commands. IMAGE shows which image the container was created from. COMMAND shows the process that is running inside the container. CREATED shows how long ago the container was created. STATUS shows whether the container is running and for how long. PORTS shows which ports are exposed and mapped. NAMES is a human readable name Docker assigns, or the name you chose.

For most everyday tasks, you only need the container ID or the name. You can stop or remove a container using either one.

Important: docker ps lists only containers that are currently running. Stopped containers do not appear unless you explicitly ask for them.

Listing All Containers Including Stopped Ones

To see every container that exists on your system, including those that have exited, use:

docker ps -a

The -a flag stands for "all". This output looks similar to docker ps, but the STATUS column may show "Exited" with an exit code and timestamp. This helps you see containers that ran in the past, completed their work, and are no longer active.

A typical workflow is to check docker ps when you want to know what is currently running, and docker ps -a when you want to clean up old containers or inspect the result of previous runs.

Showing Only the Latest Container

Sometimes you just want to see the last container that was created, for example right after running a new container and wanting to recall its ID or name. You can use:

docker ps -l

This shows the most recently created container, whether it is running or exited. You can combine this with the "all" flag as needed, but usually -l alone is enough in this situation.

Limiting the Number of Containers Shown

If you have a long history of containers, the full docker ps -a output can become noisy. Use the -n option to show only a certain number of the most recently created containers:

docker ps -a -n 5

This shows only the 5 most recent containers. The number can be adjusted to suit your needs. Without -a, -n still only affects running containers, which is usually less useful.

Formatting and Filtering Output

As you work with Docker more often, you may want to tailor the output of docker ps so that it shows only the information you care about.

To filter containers, use the --filter option. For example, to list only running containers created from a specific image:

docker ps --filter "ancestor=nginx"

Or to list containers with a certain name pattern:

docker ps --filter "name=web"

Filters can also work with status, such as "running" or "exited". This is useful when you have many containers and want to focus on a specific subset.

To change the columns or format, use the --format option. A common pattern is to show only the container ID and names:

docker ps --format "{{.ID}} {{.Names}}"

You can combine filters and formatting together when you need a compact, customized list of containers.

Checking Container Status Quickly

In practice, you will often use docker ps repeatedly when working with containers. For example, after starting a container, you might run docker ps to confirm it is running. After stopping or removing a container, you might run docker ps or docker ps -a to verify that it is gone or has exited.

Over time you will develop your own habits, but these basic commands cover almost all container listing needs:

docker ps for running containers.
docker ps -a for all containers.
docker ps -l for the last created container.
docker ps -a -n N to see a recent subset.

Views: 0

Comments

Please login to add a comment.

Don't have an account? Register now!

Where to Move

Move chapter:

  • ☰ 1. Introduction
    • ☰ 1.1. What is Docker?
      • ☰ 1.2. Why Docker?
        • ☰ 1.3. Virtual Machines vs Containers
          • ☰ 1.4. When Not to Use Docker
            • ☰ 1.5. How Docker Is Used in Real Projects
            • ☰ 2. Core Concepts
              • ☰ 2.1. Images
                • ☰ 2.2. Containers
                  • ☰ 2.3. Docker Engine and Architecture
                    • ☰ 2.4. Docker Hub and Container Registries
                      • ☰ 2.5. Tags, Versions, and Digests
                      • ☰ 3. Installing Docker
                        • ☰ 3.1. Docker on Linux
                          • ☰ 3.2. Docker on Windows
                            • ☰ 3.3. Docker on macOS
                              • ☰ 3.4. Verifying the Installation
                                • ☰ 3.5. Common Installation Issues
                                • ☰ 4. Your First Docker Container
                                  • ☰ 4.1. Running Your First Container
                                    • ☰ 4.2. Understanding `docker run`
                                      • ☰ 4.3. Interactive vs Detached Mode
                                        • ☰ 4.4. Stopping and Removing Containers
                                          • ☰ 4.5. Listing Containers
                                          • ☰ 5. Working with Docker Images
                                            • ☰ 5.1. Pulling Images from Docker Hub
                                              • ☰ 5.2. Listing and Removing Images
                                                • ☰ 5.3. Image Layers Explained
                                                  • ☰ 5.4. Image Size Optimization
                                                    • ☰ 5.5. Inspecting Images
                                                    • ☰ 6. Dockerfiles – Building Your Own Images
                                                      • ☰ 6.1. What Is a Dockerfile?
                                                        • ☰ 6.2. Basic Dockerfile Structure
                                                          • ☰ 6.3. Common Instructions (`FROM`, `RUN`, `COPY`, `CMD`, `ENTRYPOINT`)
                                                            • ☰ 6.4. Building Images with `docker build`
                                                              • ☰ 6.5. Best Practices for Dockerfiles
                                                                • ☰ 6.6. Multi-Stage Builds
                                                                • ☰ 7. Managing Data with Volumes
                                                                  • ☰ 7.1. Why Containers Are Ephemeral
                                                                    • ☰ 7.2. Bind Mounts vs Volumes
                                                                      • ☰ 7.3. Creating and Using Volumes
                                                                        • ☰ 7.4. Inspecting and Removing Volumes
                                                                          • ☰ 7.5. Real-World Examples
                                                                          • ☰ 8. Networking in Docker
                                                                            • ☰ 8.1. Docker Networking Basics
                                                                              • ☰ 8.2. Bridge Networks
                                                                                • ☰ 8.3. Port Mapping
                                                                                  • ☰ 8.4. Container-to-Container Communication
                                                                                    • ☰ 8.5. Custom Networks
                                                                                    • ☰ 9. Docker Compose
                                                                                      • ☰ 9.1. Why Docker Compose?
                                                                                        • ☰ 9.2. `docker-compose.yml` Structure
                                                                                          • ☰ 9.3. Defining Services, Networks, and Volumes
                                                                                            • ☰ 9.4. Running Multi-Container Applications
                                                                                              • ☰ 9.5. Web App and Database Example
                                                                                                • ☰ 9.6. Docker Compose Best Practices
                                                                                                • ☰ 10. Debugging and Monitoring Containers
                                                                                                  • ☰ 10.1. Viewing Logs
                                                                                                    • ☰ 10.2. Executing Commands in Running Containers
                                                                                                      • ☰ 10.3. Inspecting Containers
                                                                                                        • ☰ 10.4. Resource Usage
                                                                                                          • ☰ 10.5. Common Errors and Fixes
                                                                                                          • ☰ 11. Security Basics
                                                                                                            • ☰ 11.1. Running Containers as Non-Root
                                                                                                              • ☰ 11.2. Image Trust and Verification
                                                                                                                • ☰ 11.3. Secrets and Environment Variables
                                                                                                                  • ☰ 11.4. Reducing Attack Surface
                                                                                                                    • ☰ 11.5. Security Best Practices
                                                                                                                    • ☰ 12. Performance and Optimization
                                                                                                                      • ☰ 12.1. Reducing Image Size
                                                                                                                        • ☰ 12.2. Caching and Layer Ordering
                                                                                                                          • ☰ 12.3. Resource Limits
                                                                                                                            • ☰ 12.4. Choosing the Right Base Image
                                                                                                                            • ☰ 13. Docker in Development Workflows
                                                                                                                              • ☰ 13.1. Docker for Local Development
                                                                                                                                • ☰ 13.2. Hot Reloading with Volumes
                                                                                                                                  • ☰ 13.3. Docker and Git
                                                                                                                                    • ☰ 13.4. Docker in CI/CD Pipelines
                                                                                                                                      • ☰ 13.5. Common Development Patterns
                                                                                                                                      • ☰ 14. Deployment Basics
                                                                                                                                        • ☰ 14.1. Running Containers in Production
                                                                                                                                          • ☰ 14.2. Environment Configuration
                                                                                                                                            • ☰ 14.3. Restart Policies
                                                                                                                                              • ☰ 14.4. Logging Strategies
                                                                                                                                                • ☰ 14.5. Basic Scaling Concepts
                                                                                                                                                • ☰ 15. Beyond the Basics
                                                                                                                                                  • ☰ 15.1. Docker Swarm Overview
                                                                                                                                                    • ☰ 15.2. Kubernetes vs Docker
                                                                                                                                                      • ☰ 15.3. Container Registries
                                                                                                                                                        • ☰ 15.4. When to Move Beyond Docker
                                                                                                                                                        • ☰ 16. Practical Projects
                                                                                                                                                          • ☰ 16.1. Dockerizing a Simple Web App
                                                                                                                                                            • ☰ 16.2. Dockerizing a Backend API
                                                                                                                                                              • ☰ 16.3. Full-Stack App with Docker Compose
                                                                                                                                                                • ☰ 16.4. Common Project Pitfalls
                                                                                                                                                                • ☰ 17. Troubleshooting and FAQ
                                                                                                                                                                  • ☰ 17.1. Common Beginner Mistakes
                                                                                                                                                                    • ☰ 17.2. Docker Command Cheat Sheet
                                                                                                                                                                      • ☰ 17.3. FAQ
                                                                                                                                                                        • ☰ 17.4. Useful Resources