github.com/containers/podman/v5@v5.1.0-rc1/docs/source/markdown/options/creds.md (about)

     1  ####> This option file is used in:
     2  ####>   podman build, container runlabel, farm build, kube play, manifest add, manifest push, pull, push, search
     3  ####> If file is edited, make sure the changes
     4  ####> are applicable to all of those.
     5  #### **--creds**=*[username[:password]]*
     6  
     7  The [username[:password]] to use to authenticate with the registry, if required.
     8  If one or both values are not supplied, a command line prompt appears and the
     9  value can be entered. The password is entered without echo.
    10  
    11  Note that the specified credentials are only used to authenticate against
    12  target registries.  They are not used for mirrors or when the registry gets
    13  rewritten (see `containers-registries.conf(5)`); to authenticate against those
    14  consider using a `containers-auth.json(5)` file.