Include in the installation guide about the expected naming of the binary #368

Activity

1. amias-channer commented on Jun 10, 2025

   

   amias-channer

   on Jun 10, 2025

   Last edited by thaJeztah

   More actions

   this seems to be impossible to use .

   looks like there is some broken logic behind this , i cannot find a value that works, it seems like docker-credential-pass cannot be used but it cannot work with anything

   azureuser@sandbox-3:~/$ cat ~/.docker/config.json
   {
           "credsStore": "-pass"
   }
   azureuser@sandbox-3:~/$ cat ~/.token | docker login ghcr.io -u amias-channer --password-stdin
   Error saving credentials: error storing credentials - err: exec: "docker-credential--pass": executable file not found in $PATH, out: 
   azureuser@sandbox-3:~/$ vi ~/.docker/config.json
   
   azureuser@sandbox-3:~/$ cat ~/.docker/config.json
   {
           "credsStore": "pass"
   }
   azureuser@sandbox-3:~/$ cat ~/.token | docker login ghcr.io -u amias-channer --password-stdin
   Error saving credentials: error storing credentials - err: exit status 1, out: pass not initialized: exec: "pass": executable file not found in $PATH:
   azureuser@sandbox-3:~/$ ls -l /usr/local/bin/docker-credential-pass
   -rwxr-xr-x 1 root root 2117784 Jun 10 13:27 /usr/local/bin/docker-credential-pass
   azureuser@sandbox-3:~/$ sudo mv /usr/local/bin/docker-credential-pass /usr/local/bin/pass
   azureuser@sandbox-3:~/$ cat ~/.token | docker login ghcr.io -u amias-channer --password-stdin
   Error saving credentials: error storing credentials - err: exec: "docker-credential-pass": executable file not found in $PATH, out: 

   this is ridiculous , i don't think i have broken this
2. amias-channer commented on Jun 10, 2025

   

   amias-channer

   on Jun 10, 2025

   More actions

   I think i can see the confusion -

   pass is the name of ubuntu package that provides a password manager

   this is colliding with weird naming logic of this command and some vague documentation which mentions copying this helper to a binary called 'pass' which is somehow fudged from docker-credential-pass .

   please for the love of god refactor this code , its causing a huge amount of chaos and confusion and needs to be replaced.

   Please just stop trying to be clever with the binary name , make it an absolute path and let us manage it
3. csjewell commented on May 9, 2026

   

   csjewell

   on May 9, 2026

   Last edited by csjewell

   More actions

   (Drive-by-comment - I'm not a maintainer)

   Said vague documentation, wherever you found it, is incorrect - the helper for pass that you download from here needs to be named docker-credential-pass and needs to be on the path. (That could be made clearer in the README.md, yes. It's the Docker CLI setting the requirement for the "docker-credential-X" name, not the code in this repository.) Then you set the "credsStore" key to "pass" (quote: "Set the credsStore option in your ~/.docker/config.json file with the suffix of the program you want to use.")

   That particular helper will call pass to store and retrieve passwords, so you WILL need to install pass first - in your case, via the Ubuntu package - and then configure it to your liking (install a graphical helper? use gpg-agent?) before you start using this.

   Another option is if the DBus secret service - which is available and included in many recent Linux distributions (GNOME Keyring and KWallet both implement it, for example) - works for you, you could use docker-credential-secretservice instead, which is ALSO downloadable from here. (I use Ubuntu for work and Omarchy on my personal desktop, and that's what I use.)
4. csjewell

   added a commit that references this issue on May 9, 2026

   Specify file name in installation directions

   ...

   0b68197