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
- Click Image Library in the sidebar
- Click the Pull Image button in the toolbar
- In the search field, type:
nginx - Results from Docker Hub appear showing:
- Image name, description, star count, official badge
- Click nginx to select it
- Choose a tag from the dropdown — e.g.,
alpine,latest,1.25 - Click Pull
- A progress indicator shows pull progress (downloading layers)
- When complete, the image appears in the Images list
Scenario 2: Pull by Exact Name and Tag
- Click Image Library → Pull Image
- In the image field, enter the full image reference:
postgres:16-alpine - Click Pull
- The image downloads directly without searching
Scenario 3: Pull from a Private Registry
- First, add the registry in Settings → Registries
- Click Image Library → Pull Image
- Enter the full registry path:
registry.example.com/myteam/myapp:v2.1 - Click Pull
- 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
:latesttag 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