Business
Jobs
  • About Us
  • Solutions
    • Job Postings
      Post your job and receive qualified candidates in 48h.
    • Candidate Assessments
      500+ technical and psychological tests, plus anti-fraud.
    • Headhunting
      Tailor-made executive search from start to finish.
    • Payroll + EOR
      Payroll dispersal and EOR across 15+ LATAM countries.
  • Pricing
  • Jobs

0

116
Views
docker - Restrictions regarding naming image

I have questions regarding restrictions about naming images. I search online and saw different issue and answers.

which special characters are not allowed in docker image name? (e.g. '*', '$', ',', '_' ...) Is it possible to use uppercase char for image name?

about 4 years ago · Santiago Trujillo
2 answers
Answer question

0

From https://github.com/docker/distribution/blob/master/reference/regexp.go:

// nameComponentRegexp restricts registry path component names to start
// with at least one letter or number, with following parts able to be
// separated by one period, one or two underscore and multiple dashes.

This applies to the image name itself.

  • The regex for the letters is all lower case, no upper case letters.
  • You can include a hostname and an optional port number after a colon at the very beginning.
  • You can include a path between the hostname and image name with slashes /, and each element of the path has the same restrictions as the image name itself.
  • After the image name, you can append a tag after a colon or a digest after an @.

Expressed with the common bracketed notation:

[somehost.com[:1234]][/some-path/to/the]image-name[:myTag1.2.3]
[somehost.com[:1234]][/some-path/to/the]image-name[@ca468b84b84846e84...]
about 4 years ago · Santiago Trujillo Report

0

This documentation describes the rules for the docker image name and tag: https://docs.docker.com/engine/reference/commandline/tag/#extended-description

Name components may contain lowercase letters, digits and separators. A separator is defined as a period, one or two underscores, or one or more dashes. A name component may not start or end with a separator.

A tag name must be valid ASCII and may contain lowercase and uppercase letters, digits, underscores, periods and dashes. A tag name may not start with a period or a dash and may contain a maximum of 128 characters.

about 4 years ago · Santiago Trujillo Report
Answer question
Find remote jobs

Discover the new way to find a job!

Top jobs
Top job categories
Business
Post vacancy Pricing Sales
Legal
Terms and conditions Privacy policy
© 2026 PeakU Inc. All Rights Reserved.
Andres GPT
Show me some job opportunities
There's an error!