Skip to content


Repository files navigation

Docker Auto Labels

Automatically generate Docker Swarm mode node labels for each constraint label in each service in a Docker Compose / Docker Stack file.


This command line package is made to be used with a Docker Swarm mode cluster.

It will:

  • Read a Docker Compose / Docker Stack file.
  • Extract the node label constraints for each service.
  • Check that all the labels exist in the Docker Swarm mode cluster.
  • For each label that doesn't exist, create it in a random node in the cluster.

Adding label constraints helps you ensure that all the "stateful" Docker services (like databases) are always deployed to the same node (specially useful in a multi-node cluster).

This program will ensure that those labels exist in one node in the cluster, if they don't exist, they are created in one node chosen randomly.

That way, the first time you deploy a stack, a random node will be assigned to each stateful service (by this command, right before the deployment).

And for all subsequent deployments, the stateful services will go to the same nodes that they were using.

For examples on how to use it, check:

Release Notes

Latest Changes


  • 🔧 Add GitHub templates for discussions and issues, and security policy. PR #9 by @alejsdev.
  • 🔧 Add funding. PR #8 by @tiangolo.
  • 👷 Add latest-changes GitHub Action. PR #6 by @tiangolo.
  • 👷 Add dependabot. PR #7 by @tiangolo.



MIT License


Generate each Docker constraint label in random nodes in the cluster.



Security policy




Sponsor this project



No packages published