Skip to content

docs: add Podman troubleshooting guide#72

Open
debojitroy wants to merge 1 commit into
antkawam:mainfrom
debojitroy:docs/podman-troubleshooting
Open

docs: add Podman troubleshooting guide#72
debojitroy wants to merge 1 commit into
antkawam:mainfrom
debojitroy:docs/podman-troubleshooting

Conversation

@debojitroy
Copy link
Copy Markdown

Summary

  • Adds a Podman troubleshooting section to docs/faq.md covering three common rootless Podman issues:
    • UID/GID namespace mapping failures (especially for domain users where the qualified username doesn't match /etc/subuid)
    • Outdated crun OCI runtime causing "unknown version" errors
    • AWS SSO credential permission errors due to UID remapping in volume mounts
  • Updates docs/getting-started.md and README.md to mention Podman as a supported alternative with a link to the troubleshooting guide

Test plan

  • Verify markdown renders correctly on GitHub
  • Verify FAQ anchor link faq.md#podman resolves correctly
  • Confirm steps work on a fresh rootless Podman setup with an SSO profile

🤖 Generated with Claude Code

Covers three common issues when running CCAG with podman-compose:
UID/GID namespace mapping failures (especially for domain users),
outdated crun OCI runtime, and AWS SSO credential permission errors.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant