Skip to content

Add local Docker build instructions and custom registry support#7

Merged
michaelmoore-s1 merged 2 commits intomainfrom
docker-local-builds
Nov 9, 2025
Merged

Add local Docker build instructions and custom registry support#7
michaelmoore-s1 merged 2 commits intomainfrom
docker-local-builds

Conversation

@michaelmoore-s1
Copy link
Contributor

Summary

This PR adds comprehensive documentation for building Docker images locally and pushing them to custom container registries, giving users full control over their deployment workflow.

Changes

Documentation Updates

  • DOCKER.md:

    • Reorganized to lead with local build instructions
    • Added section on tagging and pushing images to custom registries (Docker Hub, AWS ECR, GCP GCR, Azure ACR, private registries)
    • Updated Kubernetes example to use your-registry.example.com placeholder
  • README.md:

    • Updated Docker quick start to show local build step
    • Removed references to pre-built images
  • PRODUCTION_SETUP.md:

    • Updated quick reference to show local build commands
    • Added docker compose build alternative
  • CONTRIBUTING.md:

    • Updated note about production deployments to reference local builds

Workflow Changes

  • Removed .github/workflows/publish.yml (GHCR publishing workflow)
  • Build cache in CI workflows continues to use GHCR for performance

Benefits

  • Users can build and customize images for their specific needs
  • Full control over image registry and distribution
  • Supports air-gapped and private network deployments
  • Works with any container registry (cloud or self-hosted)

Testing

All existing Docker tests pass with local builds. The docker-compose.yml already uses build: context and requires no changes.

This commit adds comprehensive documentation for building Docker images
locally and pushing them to custom container registries, giving users
full control over their deployment workflow.

Changes:
- Updated DOCKER.md with local build instructions and custom registry guide
- Updated README.md to show local build in Docker quick start
- Updated PRODUCTION_SETUP.md with local build commands
- Updated CONTRIBUTING.md references to local builds
- Removed publish.yml workflow (GHCR publishing)
- Build cache in CI continues to use GHCR for performance
Keep Docker section with local build instructions while preserving
authentication note from main branch.
@michaelmoore-s1 michaelmoore-s1 merged commit cac1b5d into main Nov 9, 2025
13 of 14 checks passed
@michaelmoore-s1 michaelmoore-s1 deleted the docker-local-builds branch November 9, 2025 03:28
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