Elysia Tools
Navigation
Validation
Validate Docker image names and tags according to Docker naming conventions
Execution
Fill in the form, run the tool, and review the result in one place.
Samples
Related
Ready for a run
Tool usage guide
The Docker Image Tag Validator checks if a given Docker image reference, including name and tag, adheres to Docker's official naming conventions. It helps ensure that image references are correctly formatted for use in container registries and deployments.
Background
A developer is setting up a new project and needs to use the official Node.js image.
Problem
Ensure that the image reference 'node:14-alpine' is valid and follows Docker conventions.
How to use
Enter 'node:14-alpine' into the Docker Image Reference input field.
Outcome
The tool confirms the reference is valid, allowing the developer to proceed with confidence.
Background
An operations engineer is configuring a deployment that uses an image from a private registry with a specific tag.
Problem
Validate the reference 'registry.example.com/team/app:v2.1.0-beta' to ensure it's correctly formatted.
How to use
Input 'registry.example.com/team/app:v2.1.0-beta' into the tool.
Outcome
Validation succeeds, confirming that the registry path, repository, and tag are all compliant.
A Docker image reference is a string that identifies a Docker image, typically in the format [registry/]repository[:tag] or [registry/]repository[@digest].
Repository names must be lowercase, can include dots, dashes, and underscores, and tags must consist of valid ASCII characters without spaces.
Yes, it can check references that include digests, such as 'nginx@sha256:abc123...'.
Docker imposes length limits on repository names and tags; the tool verifies compliance with these limits.
Review the error message provided by the tool to identify and correct the invalid part of the image reference.