moby/docs/sources/commandline/command/build.rst

:title: Build Command
:description: Build a new image from the Dockerfile passed via stdin
:keywords: build, docker, container, documentation

================================================
``build`` -- Build a container from a Dockerfile
================================================

::

    Usage: docker build [OPTIONS] PATH | URL | -
    Build a new container image from the source code at PATH
      -t="": Tag to be applied to the resulting image in case of success.
    When a single Dockerfile is given as URL, then no context is set. When a git reppository is set as URL, the repository is used as context


Examples
--------

.. code-block:: bash

    docker build .

This will take the local Dockerfile

.. code-block:: bash

    docker build -

This will read a Dockerfile form Stdin without context