Docs

Accessing the Image Builder

What this screen is for

Image Builder is reachable from two places, and which one you pick decides whether you start from a blank form or a pre-filled template.

Before you start

To do this You need
Use either entry point the local-env Dockerfile read permission

Opening it

Build › Image Builder, or Tools › Templates Library.

The Image Builder tools are accessible from two locations in the sidebar.

Entry Point Location Description Best For
Image Builder Build → Image Builder Start with a blank form and build your Dockerfile step-by-step Specific requirements from the start
Templates Library Tools → Templates Library Browse pre-filled templates, then customize as needed Quick start with common patterns

Direct URLs:

  • From-scratch generator: /developer-tools/from-scratch-docker-generator
  • Templates library: /developer-tools/predefined-templates-library

Note: Both entry points lead to the same Dockerfile Generator interface. Templates simply pre-populate the form fields, which you can freely modify.

📸 Screenshot Placeholder: The two entry points in the sidebar — Build > Image Builder and Tools > Templates Library. Mark: (1) each menu entry.

Scenario

Choosing between the two entry points.

  1. Ask whether your stack is common. If it is, the Templates Library will have something close, and adapting it beats filling a blank form.
  2. If your requirements are specific from the outset — an unusual base image, a multi-stage build you already have in mind — start blank. A template you override entirely is slower than no template.
  3. Either way you land in the same generator. A template only pre-populates the fields, and every one of them stays editable.

When it doesn’t work

Symptom Cause How to check Fix
The two entry points look identical They are — templates only pre-fill the form — Expected
A template’s values are wrong for you Every field stays editable The form Change them

Next