Official Repository

Last pushed: 2 months ago
Short Description
Hello World! (an example of minimal Dockerization)
Full Description

Supported tags and respective Dockerfile links

For more information about this image and its history, please see the relevant manifest file (library/hello-world). This image is updated via pull requests to the docker-library/official-images GitHub repo.

For detailed information about the virtual/transfer sizes and individual layers of each of the above supported tags, please see the repos/hello-world/ file in the docker-library/repo-info GitHub repo.

Example output

$ docker run hello-world

Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
 1. The Docker client contacted the Docker daemon.
 2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
 3. The Docker daemon created a new container from that image which runs the
    executable that produces the output you are currently reading.
 4. The Docker daemon streamed that output to the Docker client, which sent it
    to your terminal.

To try something more ambitious, you can run an Ubuntu container with:
 $ docker run -it ubuntu bash

Share images, automate workflows, and more with a free Docker ID:

For more examples and ideas, visit:

$ docker images hello-world
hello-world  latest  48b5124b2768  1.84 kB

How is this image created?

This image is a prime example of using the scratch image effectively. See hello.asm in for the source code of the hello binary included in this image.

Supported Docker versions

This image is officially supported on Docker version 17.03.0-ce.

Support for older versions (down to 1.6) is provided on a best-effort basis.

Please see the Docker installation documentation for details on how to upgrade your Docker daemon.

User Feedback


If you have any problems with or questions about this image, please contact us through a GitHub issue. If the issue is related to a CVE, please check for a cve-tracker issue on the official-images repository first.

You can also reach many of the official image maintainers via the #docker-library IRC channel on Freenode.


You are invited to contribute new features, fixes, or updates, large or small; we are always thrilled to receive pull requests, and do our best to process them as fast as we can.

Before you start to code, we recommend discussing your plans through a GitHub issue, especially for more ambitious contributions. This gives other contributors a chance to point you in the right direction, give you feedback on your design, and help you find out if someone else is working on the same thing.


Documentation for this image is stored in the hello-world/ directory of the docker-library/docs GitHub repo. Be sure to familiarize yourself with the repository's file before attempting a pull request.

Docker Pull Command

Comments (17)
a month ago

The docs seem outdated.

See hello.asm in for the source code of the hello binary included in this image.

there is no hello.asm in that repo.

a month ago

awesome, my older brother

5 months ago

I get this when trying to run hello_world :

Unable to find image 'hello_world:latest' locally
Pulling repository
C:\Program Files\Docker Toolbox\docker.exe: Error: image library/hello_world:latest not found.
See 'C:\Program Files\Docker Toolbox\docker.exe run --help'.

6 months ago


7 months ago

Newbies not to understand anything with that example.

7 months ago

This example is not starting

7 months ago

i test install and configure docker on ubuntu on ibm power systems (linux on power). but i cannot start docker container on my systems. i found error detail as below.

natitad@dockerubuntuppc64:~$ sudo docker images
ubuntu 14.04 d9560c05d6bd 3 days ago 188 MB
mongo latest 96267d06ead4 2 weeks ago 326.7 MB
httpd latest 929f5c8eee3f 2 weeks ago 195.4 MB
httpd 2.4 929f5c8eee3f 2 weeks ago 195.4 MB
hello-world latest 95f1eedc264a 6 weeks ago 1.848 kB
natitad@dockerubuntuppc64:~$ sudo docker run hello-world
exec format error
Error response from daemon: Cannot start container 9d7809d260978643ced8da0c64bda50e3261fe531654c773d7e34e638e7d2940: [8] System error: exec format error

Please help guide me
Thank you
Natitad S.

10 months ago

@sarjunkumar24391 do you have the output from when you try to run the container? Maybe something is wrong with your tags and it's still pulling the (unaltered) version from the repository instead of your local updated version.

10 months ago

@galope (maybe @alexus as well), RPi is an ARM architecture so the Docker-based apps have to be specifically packaged for that architecture (which the hello-world app isn't). You'll have to look for apps that are packaged for ARM. A good resource on the subject can be found here:

a year ago

I looked in the souce code and understood how the output is generated. but if i change the message in the hello.asm file and build a new automated image in docker hub, the message is not updated.... its still showing "Hello from Docker"...