[archive plugin] Getting credentials error when updating "swift:amazonlinux2" docker image on macOS

[xBrux]

Describe the bug

Environment

• macOS: 26.1
• Swift: swift-6.2.1-RELEASE
• Docker Desktop: 4.52.0 (210994) | 4.53.0 (211793)
• swift-aws-lambda-runtime: main

When archiving Lambda, Docker fails to pull the required image:

swift package archive --allow-network-connections docker

-------------------------------------------------------------------------
building "pawbox-lambdas" in docker
-------------------------------------------------------------------------
updating "swift:amazonlinux2" docker image
  error getting credentials - err: exit status 1, out: `One or more parameters passed to the function were not valid. (-50)`
error: /usr/local/bin/docker pull swift:amazonlinux2 failed with code 1

However, running the same command manually in Terminal works:

docker pull swift:amazonlinux2

Expected Behavior

swift package archive --allow-network-connections docker
should be able to successfully pull the required Docker image (e.g. swift:amazonlinux2) and complete the Lambda archive process.

Current Behavior

When archiving Lambda, Docker fails to pull the required image:

swift package archive --allow-network-connections docker

-------------------------------------------------------------------------
building "pawbox-lambdas" in docker
-------------------------------------------------------------------------
updating "swift:amazonlinux2" docker image
  error getting credentials - err: exit status 1, out: `One or more parameters passed to the function were not valid. (-50)`
error: /usr/local/bin/docker pull swift:amazonlinux2 failed with code 1

Reproduction Steps

1. Update to the latest Docker Desktop (macOS 26.1, Docker Desktop: 4.52.0 (210994) or 4.53.0 (211793));
2. In a Swift AWS Lambda project, run: swift package archive --allow-network-connections docker.

Possible Solution

No response

Additional Information/Context

No response

AWS SWIFT SDK version used

swift-aws-lambda-runtime 2.4.0 (main-branch)

Compiler and Version used

swift-6.2.1-RELEASE or Xcode 26.1.1

Operating System and version

macOS 26.1

[sebsto]

Hello @xBrux
I'm sorry you're having this issue.
This is not directly related to the plugin.

The error message says that the command docker pull swift:amazonlinux2 can not get credentials

Can you try to run this command from a terminal ?

docker pull swift:amazonlinux2

Kiro (https://kiro.dev) told me this:

This error suggests an issue with Docker credential retrieval on macOS. The
error code -50 typically indicates a keychain access problem. Here are the steps
to resolve it:

1. Reset Docker credentials:

docker logout

2. Clear Docker credential store:

rm -rf ~/.docker/config.json

3. If using Docker Desktop, restart it:

killall Docker && open /Applications/Docker.app

4. Check your keychain access:

security unlock-keychain ~/Library/Keychains/login.keychain

5. Try the pull command again:

docker pull swift:amazonlinux2

If the issue persists, you can temporarily disable the credential store by
editing ~/.docker/config.json and removing the credsStore entry:

{
  "auths": {}
}

The -50 error is commonly caused by macOS keychain permissions or corrupted
credential entries. Restarting Docker Desktop usually resolves the credential
helper issues.

[xBrux]

Hello @sebsto
Thank you for your reply.

Actually, I can run this command from a terminal without any issue docker pull swift:amazonlinux2.

The error only occurs during the swift package archive --allow-network-connections docker process. So I suspect the issue may be within the archive plugin or the environment it uses to invoke Docker.

Please let me know if I can provide more logs or environment details to help diagnose the issue.

Thanks again for the assistance!