Troubleshooting
Common issues when adopting the registry, and how to resolve them.
Authentication still fails after logging in (macOS)
On macOS, SwiftPM may prefer a Keychain entry over netrc. If requests stay unauthenticated after swiftregistry login, clear the stale Keychain item for the registry host, or configure SwiftPM to use netrc.
'.package(id:) is unavailable'
Registry dependencies require swift-tools-version 5.7 or later. Bump the version at the top of Package.swift.
SwiftPM refuses an http registry
SwiftPM blocks plaintext http by default. Use an https registry URL. For local testing only, SwiftPM accepts --allow-insecure-http.
No Package.resolved after resolving
A package with no dependencies does not produce a Package.resolved file — that is expected, not an error.
Still stuck? swiftregistry doctor diagnoses your registry configuration read-only, and analyze inspects a resolved dependency graph.