Skip to content

fix: Podman compatibility by adding environment configurable repository prefix to Docker Compose image references#2002

Open
Vchen7629 wants to merge 1 commit into
mainfrom
openrag-install-linux-vm-fix
Open

fix: Podman compatibility by adding environment configurable repository prefix to Docker Compose image references#2002
Vchen7629 wants to merge 1 commit into
mainfrom
openrag-install-linux-vm-fix

Conversation

@Vchen7629

@Vchen7629 Vchen7629 commented Jul 2, 2026

Copy link
Copy Markdown
Collaborator

Summary

Port of PR #1919 to target main instead of release-0.5.1 branch, Fixes #1206. Podman fails to resolve unqualified image names (no registry prefix) by default, causing podman pull/podman compose up to fail with: Error: short-name "langflowai/openrag-backend:latest" did not resolve to an alias and no unqualified-search registries are defined in "/etc/containers/registries.conf"

Changes

  • Prefix all image references in docker-compose.yml with Added environment variable prefix that defaults to docker.io/ (5 images total: opensearch, opensearch-dashboards, backend, frontend, langflow) if none provided

Testing

  • Verified on Windows 10 + WSL2 + Ubuntu 24.04 + Podman 4.9.3, image pulls and podman compose up now succeed
  • Confirmed docker compose still works identically (fully-qualified docker.io/... and unqualified ... resolve to the same image on Docker Hub)
  • Ran unit test suite

Summary by CodeRabbit

  • Chores
    • Updated container image references to use fully qualified registry paths for core services.
    • No changes were made to ports, volumes, environment settings, or service behavior.

…or private repo compatibility

Signed-off-by: vchen7629 <[email protected]>
@Vchen7629 Vchen7629 requested a review from lucaseduoli July 2, 2026 19:09
@github-actions github-actions Bot added the docker label Jul 2, 2026
@coderabbitai

coderabbitai Bot commented Jul 2, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 4616f1e0-d5e6-42fa-b6f1-e80ab04b83c5

📥 Commits

Reviewing files that changed from the base of the PR and between 4f104ec and d79d3f5.

📒 Files selected for processing (1)
  • docker-compose.yml

Walkthrough

Updated docker-compose.yml to prefix five service image references (opensearch, dashboards, openrag-backend, openrag-frontend, langflow) with the fully-qualified docker.io/ registry path instead of unqualified image names.

Changes

Docker image path qualification

Layer / File(s) Summary
Qualify service image references
docker-compose.yml
Image references for opensearch, dashboards, openrag-backend, openrag-frontend, and langflow services updated to use fully-qualified docker.io/... paths.

Estimated code review effort: 1 (Trivial) | ~3 minutes

Related issues: #1206 — Fixes OpenRAG TUI installation failure on Linux/Podman systems caused by unqualified image names lacking a registry prefix.

Suggested labels: bug

🚥 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 The title matches the main change: qualifying OpenRAG image references in docker-compose for Podman compatibility.
Linked Issues check ✅ Passed Qualifying the five OpenRAG image references addresses the unqualified short-name failure described in #1206.
Out of Scope Changes check ✅ Passed The diff stays within the requested docker-compose image reference fix and adds no unrelated changes.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch openrag-install-linux-vm-fix

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

Comment @coderabbitai help to get the list of available commands.

@github-actions github-actions Bot added the bug 🔴 Something isn't working. label Jul 2, 2026
@github-actions github-actions Bot added the lgtm label Jul 3, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bug 🔴 Something isn't working. docker lgtm

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Bug]: OpenRAG installation on fails on Linux VMs via TUI due to use of unqualified prefix in OpenRAG containers

2 participants