Skip to content

refactor: Update Docker image handling and registry configuration#321

Merged
AnkushMalaker merged 1 commit into
devfrom
fix/unify-docker-stuff
Mar 1, 2026
Merged

refactor: Update Docker image handling and registry configuration#321
AnkushMalaker merged 1 commit into
devfrom
fix/unify-docker-stuff

Conversation

@AnkushMalaker

@AnkushMalaker AnkushMalaker commented Mar 1, 2026

Copy link
Copy Markdown
Collaborator

Overview

Migrates the Docker image ecosystem from a DockerHub-centric approach to GHCR (GitHub Container Registry) as the default, while keeping backward compatibility with DockerHub and supporting arbitrary custom registries.


Image Name Standardization

All images renamed to a consistent chronicle-* prefix:

Old Name New Name
advanced-chronicle-backend chronicle-backend
advanced-workers (removed)
advanced-webui chronicle-webui
parakeet-asr-{cuda} chronicle-asr-nemo-{cuda}
speaker-recognition-{cuda} chronicle-speaker-{cuda}
openmemory-mcp (removed from CI)

Registry Precedence (3-tier)

All scripts and services.py now share the same precedence logic:

Priority Env Var Use Case
1 CHRONICLE_REGISTRY Custom registry
2 DOCKERHUB_USERNAME Backward compatibility
3 ghcr.io/simpleopensoftware/ Default (no auth needed)

Changes Per File

1. .github/workflows/advanced-docker-compose-build.yml

  • Renamed all image tags to chronicle-* prefix
  • Removed openmemory-mcp from build matrix and path triggers
  • Removed separate workers image (now shares backend image)
  • Updated job summary markdown with new image names

2. scripts/pull-images.sh

  • No longer requires DOCKERHUB_USERNAME — defaults to public GHCR
  • ./scripts/pull-images.sh v1.0.0 works without any env vars
  • Added CHRONICLE_REGISTRY support for custom registries
  • Updated error messages: "DockerHub" → "registry"

3. scripts/push-images.sh

  • New CHRONICLE_PUSH_REGISTRY env var for explicit push target
  • Falls back to DOCKERHUB_USERNAME for backward compat
  • Errors if neither is set (pushing requires explicit registry)
  • Updated restore instructions to use CHRONICLE_REGISTRY=

4. services.py

  • --use-prebuilt no longer requires DOCKERHUB_USERNAME
  • Same 3-tier registry precedence as pull/push scripts
  • ./start.sh --use-prebuilt v1.0.0 works out of the box

- Modified `services.py` to support prebuilt images from GHCR and custom registries, enhancing flexibility in image management.
- Updated `pull-images.sh` and `push-images.sh` scripts to streamline image pulling and pushing processes, allowing for backward compatibility with DockerHub.
- Refactored Docker Compose configurations to align with new image naming conventions, ensuring consistency across services.
- Enhanced error messages and documentation for improved clarity on registry usage and image management.
@coderabbitai

coderabbitai Bot commented Mar 1, 2026

Copy link
Copy Markdown
Contributor

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch fix/unify-docker-stuff

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 and usage tips.

@AnkushMalaker AnkushMalaker requested a review from 0xrushi March 1, 2026 05:56
@0xrushi

0xrushi commented Mar 1, 2026

Copy link
Copy Markdown
Contributor

LGTM

@AnkushMalaker AnkushMalaker merged commit 1e6a883 into dev Mar 1, 2026
1 check passed
@AnkushMalaker AnkushMalaker deleted the fix/unify-docker-stuff branch March 1, 2026 20:56
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.

2 participants