docs: add rootless Podman troubleshooting note to README

[praveenkumar]

Description

Type of Change

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Documentation update
• Refactoring (no functional changes)
• Performance improvement
• Test coverage improvement

Related Issues

#501

Fixes #
Relates to #

Changes Made

Testing

• Unit tests pass (pytest)
• Integration tests pass
• Manual testing performed
• No new warnings or errors

Checklist

• My code follows the project's code style
• I have performed a self-review of my own code
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation
• My changes generate no new warnings
• I have added tests that prove my fix is effective or that my feature works
• New and existing unit tests pass locally with my changes
• Any dependent changes have been merged and published

Screenshots (if applicable)

Additional Notes

Summary by CodeRabbit

• Documentation
  • Updated container setup instructions with guidance for rootless Podman usage on Fedora/RHEL/CentOS to resolve Git "dubious ownership" errors.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Enterprise

Run ID: 60f22daa-fedf-43b8-8e2d-9ab7ef672fff

📥 Commits

Reviewing files that changed from the base of the PR and between 6264bb0 and bce870f.

📒 Files selected for processing (1)

• README.md

---

📝 Walkthrough

Walkthrough

Two lines added to README.md under the "Container (Recommended)" section documenting the --userns=keep-id flag for rootless Podman on Fedora/RHEL/CentOS and pointing to CONTAINER.md for full permission troubleshooting steps.

Changes

Rootless Podman Documentation

Layer / File(s)	Summary
Rootless Podman note in Container section README.md	Adds a note explaining that rootless Podman users on Fedora/RHEL/CentOS need --userns=keep-id to avoid Git "dubious ownership" errors, with a reference to CONTAINER.md#podman-rootless-mode.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	Title follows Conventional Commits format with 'docs' type and accurately describes the documentation change to add a rootless Podman troubleshooting note.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

✨ Simplify code

• Create PR with simplified code

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[github-actions]

📈 Test Coverage Report

Branch	Coverage
This PR	74.6%
Main	74.6%
Diff	✅ +0%

---

Coverage calculated from unit tests only

[jwm4]

Looks good to me. Thx!