Difficulty: Beginner
Estimated Time: 10 minutes

In this scenario we learn how to work with Docker images.

In this scenario we learned, how to work with Docker images

Docker images

Step 1 of 7

Docker images - Commit

In this step we learn how to create Docker images from a running container.

At first we query the list of locally available Docker:

docker images

We'll see at least 3 images:

REPOSITORY TAG IMAGE ID CREATED SIZE redis latest 4760dc956b2d 12 months ago 107MB ubuntu latest f975c5035748 12 months ago 112MB alpine latest 3fd9065eaf02 14 months ago 4.14MB

Pull and run the nginx example from the last scenario:

docker run --rm --name web -d -p 80:80 nginx

Verify the state of the container:

docker ps

Login into the container via docker exec command:


In our case we want to login to the web container, using the parameters are:

  • t - Allocate a pseudo-terminal
  • i - Interactvie mode

The command to be run is a Bash shell.

docker exec -ti web /bin/bash

Remark: Not all containers have Bash or even Sh installed!

Now you can perform normal operations like file listing:

ls -l

Create a file named testfile:

echo "This is a test" > testfile

and check, whether it has been created:

stat testfile

Now leave the container's shell:


Stop and re-run the container, login and verify, whether the file is still there:

docker stop web && \ docker run --name web -d -p 80:80 nginx && \ docker exec -ti web /bin/bash

stat testfile

As you see, the file is missing, all changes were lost after the container has been stopped. There are several ways to avoid this, one of them is committing the container's state into a new image. Create the file again and leave the container's shell:

echo "This is a test" > testfile && exit

You can save the container's state by committing it. Committing is similar to Git, where you commit changes into a branch or a repository. The syntax is:


Here we use:

docker commit web nginx:committed-by-user

When querying the list of locally available Docker images again, the new created images should appear:

docker images

Now you can instantiate a container from the changed image (we use another port here to avoid port binding conflicts):

docker run --name webnew -d -p 8080:80 nginx:committed-by-user

Verify that the testfile is present:

docker exec -ti webnew /bin/bash

stat testfile

Exit the container: