Back to Tutorials

Pull a Docker Image

Search Docker Hub, pull images by name and tag, and pull from private registries.

Prerequisites

  • Docker is running
  • For private registries, you must be logged in (configure in Settings → Registries)

Scenario 1: Search and Pull from Docker Hub

  1. Click Image Library in the sidebar
  2. Click the Pull Image button in the toolbar
  3. In the search field, type: nginx
  4. Results from Docker Hub appear showing:
    • Image name, description, star count, official badge
  5. Click nginx to select it
  6. Choose a tag from the dropdown — e.g., alpine, latest, 1.25
  7. Click Pull
  8. A progress indicator shows pull progress (downloading layers)
  9. When complete, the image appears in the Images list

Scenario 2: Pull by Exact Name and Tag

  1. Click Image Library → Pull Image
  2. In the image field, enter the full image reference: postgres:16-alpine
  3. Click Pull
  4. The image downloads directly without searching

Scenario 3: Pull from a Private Registry

  1. First, add the registry in Settings → Registries
  2. Click Image Library → Pull Image
  3. Enter the full registry path: registry.example.com/myteam/myapp:v2.1
  4. Click Pull
  5. Zenithal uses the stored credentials to authenticate with the registry

What You'll See

  • The Images list shows all local images with:
    • Repository name and tag
    • Image ID (short hash)
    • Size on disk
    • Created date
  • Pull progress shows a bar for each layer being downloaded
  • After pulling, the image is ready to use when creating new containers

Tips

  • Use Alpine-based tags (e.g., nginx:alpine, redis:7-alpine) for smaller image sizes
  • The :latest tag is used by default if you omit a tag — but specifying an explicit version is recommended for reproducibility
  • Multiple registries are a Pro feature — Free users can use Docker Hub only
  • You can delete unused images by right-clicking → Delete to free disk space

Related Tutorials