10 Docker Container Naming Convention Best Practices
A clear Docker container naming convention is important for effective management, organization, and easy identification of containers in complex environments.
Kashyap Merai / / docker · 4 min read
A clear Docker container naming convention is important for effective management, organization, and easy identification of containers in distributed and complex environments.
We will discuss the 10 best practices for naming Docker containers with detailed examples. We will also check the good and bad examples for the naming convention.
By following their best practices, you can ensure that Docker containers are easy to identify and manage.
1. Be Descriptive
Use a name that clearly indicates the purpose of the container. Having a clear functional container name helps anyone in a team understand the role of the Docker container.
Good 👍
wordpress-dbClear and function name indicates that this container is for WordPress Database
Bad 👎
db1No information about the container and its purpose.
2. Use Lowercase Letters
Docker container names are case-sensitive with limitations on only using uppercase, lowercase letters, digits, hyphens, underscores, and dots.
The name must follow the regex here:
https://github.com/moby/moby/blob/master/daemon/names/names.go#L6
[a-zA-Z0-9][a-zA-Z0-9_.-]- numbers
0-9 - lowercase letters
a-z - uppercase letters
A-Z - underscore
_ - point
. - hyphen
-
I recommended sticking to the lowercase letter for consistency in the Docker container naming convention.
Good 👍
nginx-proxyBad 👎
NginxProxyNot a consistent name and it looks weird 🤮
Docker Security Checklist + Guide
Practical, proven strategies to secure your containers like a pro - in under 20 minutes.
3. Avoid Special Characters
Docker container naming convention allows certain special characters such as hyphens ( - ), underscores ( _ ) and dot ( . )
For better compatibility and readability avoid other special characters and stick to the default uppercase, lowercase letters, digits, hyphens, and underscores.
Good 👍
mongo-dbBad 👎
mongo!db4. Use Short and Meaningful Names
To communicate with another container, the name must be a maximum of 63 characters else DNS will fail to resolve. Keeping the name concise and meaningful is the goal for this Docker container naming convention
- https://github.com/moby/moby/issues/46928
- You can check the source code for additional information.
Using long and complex names can create trouble and readability issues.
Good 👍
nginx-proxyBad 👎
a-long-time-ago-in-a-galaxy-someone-use-long-name5. Use Hyphens or Underscores for Separation
Docker doesn’t allow special characters other than hyphens ( - ) or underscores ( _ ). But if you use this properly this can increase the readability of your Docker container naming convention.
Good 👍
python-backendBad 👎
pythonbackendWell, why use long names without separation? It looks ugly and hard to read.
I will not include a bad example here as this is optional.
Master Docker Security - Without the Guesswork
Get the exact steps top engineers use to secure production containers. 100% free.
6. Include Environment Information
If you run multiple containers in the same or different environment such as development, staging, or production, consider including the environment-related information in Docker container naming conventions.
Good 👍
webserver-productionBad 👎
webserver7. Avoid Ambiguity
Docker will not allow to have a duplicate container name but ensure that each Docker container is unique within the environment.
This will help to avoid any conflict and confusion.
Good 👍
app-backendBad 👎
appHere app can be any app frontend or backend.
8. Avoid Using Generic Names
I’m sure most users use generic terms while naming the Docker container, it’s easy to remember right?
The best practice for the Docker container naming convention is to avoid generic names like “web”, “database”, “app” or “server”
Avoid this unless they reflect the purpose and no duplication or ambiguity.
Good 👍
wordpressBad 👎
webDocker Security Checklist + Guide
Practical, proven strategies to secure your containers like a pro - in under 20 minutes.
9. Consistent Naming Convention
Define the consistent naming convention policy across the entire Docker environment. Having the policy in place makes sure that it is easy to manage and maintain over time even with cross-teams.
Good 👍
# Staging Env
nginx-proxy-staging
# Production Env
nginx-proxy-production10. Include Version Information (Optional)
Well, it’s best practice to include version information as a Docker tag rather than a name but for some reason, if you’re only using the latest as the default Docker tag then this might be helpful.
Good 👍
mysql-5.7Conclusion
By following the above Docker container naming convention tips, you can ensure that you have a well-named Docker container that is easy to understand and manage. A consistent naming scheme across the Docker environment enables you to operate and maintain long-term.
If you’re looking for how to make your Docker container secure check out the Docker Container Security Cheatsheet and don’t get hacked🔐
Kashyap Merai, a Certified Solution Architect and Public Cloud Specialist with over 8 years in IT. He helped startups in Real Estate, Media Streaming, and On-Demand industries launch successful public cloud projects.
Passionate about Space, Science, and Computers. He also mentors aspiring cloud engineers, shaping the industry's future.
Connect with him on LinkedIn to stay updated on cloud innovations.
