0
0
DockerConceptBeginner · 3 min read

What is FROM in Dockerfile: Explanation and Usage

The FROM instruction in a Dockerfile specifies the base image to start building your Docker image from. It sets the starting point for all subsequent instructions and is required as the first instruction in every Dockerfile.
⚙️

How It Works

The FROM instruction tells Docker which existing image to use as the foundation for your new image. Think of it like choosing a blank canvas before painting. This base image can be a minimal operating system, a language runtime, or any pre-built environment.

When you run a Docker build, Docker downloads this base image if it is not already on your machine. Then, it applies the rest of the instructions in the Dockerfile on top of this base, layering your customizations step by step. Without FROM, Docker wouldn't know where to start.

💻

Example

This example shows a simple Dockerfile that uses FROM to start from an official Python image and then adds a script.

dockerfile
FROM python:3.11-slim

COPY hello.py /app/hello.py

CMD ["python", "/app/hello.py"]
Output
When you build and run this image, it runs the Python script hello.py inside the container.
🎯

When to Use

Use FROM whenever you create a Dockerfile to define the base environment for your application. It is essential for:

  • Starting from a minimal OS like Alpine Linux for small images.
  • Using language-specific images like Node.js, Python, or Java to simplify setup.
  • Building multi-stage Dockerfiles by specifying multiple FROM instructions to optimize image size.

Choosing the right base image with FROM helps ensure your container has the necessary tools and libraries to run your app efficiently.

✅

Key Points

  • FROM must be the first instruction in a Dockerfile.
  • It defines the base image your container builds upon.
  • You can use official images or custom images as the base.
  • Multi-stage builds use multiple FROM instructions.
  • Choosing a lightweight base image can reduce your final image size.
✅

Key Takeaways

FROM sets the base image for your Docker build and is required in every Dockerfile.
It defines the starting environment where your app will run inside the container.
You can use official or custom images as the base depending on your needs.
Multi-stage builds use multiple FROM instructions to optimize images.
Choosing a small base image helps keep your container lightweight.

Related by keyword

How to See Docker Container Resource Usage EasilyContainersWhat is Docker Compose: Simple Explanation and UsageDocker ComposeWhat Is Volume in Docker: Simple Explanation and UsageVolumesWhat is None Network in Docker: Explanation and UsageNetworkingHow to Check Disk Usage in Docker: Commands and ExamplesDebugging

Up next

How to Use Docker Top Command to View Container ProcessesWhat Is a Docker Container? Simple Explanation and ExampleDocker Compose v1 vs v2: Key Differences and When to Use EachHow to Create docker-compose.yml for Easy Docker Setup

More in Dockerfile

Best Practices for Writing Dockerfile: Clean and Efficient ContainersCMD vs ENTRYPOINT in Dockerfile: Key Differences and UsageCOPY vs ADD in Dockerfile: Key Differences and When to Use EachENV vs ARG in Dockerfile: Key Differences and Usage