Skip to content

Conversation

@dtinth
Copy link

@dtinth dtinth commented Jan 31, 2026

Purpose

When I fork the project to make improvements, I want to be able to deploy it to my VPS for testing. I want an image built in a reproducible way. However, the current docker-hub.yml is hardcoded to push to Docker Hub under lasuite registry.

This PR adds a GitHub Actions workflow that builds and pushes Docker images to GitHub Container Registry (GHCR) trigger. This enables forked repositories to build their own images for testing without requiring Docker Hub credentials or having to configure any credentials at all.

I created this workflow while fixing #1788 (submitted as PR #1850). To verify it works, I ran the workflow on my fork:

image

This generates the images in my account:

image

Now I can test it on my VPS by pointing my Docker Compose to my built image:

image

Proposal

  • Create .github/workflows/ghcr.yml with workflow_dispatch trigger, based on existing docker-hub.yml
  • Only runs on forked repos. It will not run on the source suitenumerique/docs repo.
  • Build backend, frontend, and y-provider images
  • Push to ghcr.io/{owner}/{repo}/{service}
  • Support both manual triggers and pushes to main/tags
  • Include proper metadata tagging (branch, semver, SHA)

Notes:

  • This workflow is independent of the existing Docker Hub workflow
  • Both workflows can coexist and serve different purposes
  • GHCR is free for public repositories

External contributions

Thank you for your contribution! 🎉

Please ensure the following items are checked before submitting your pull request:

  • I have read and followed the contributing guidelines
  • I have read and agreed to the Code of Conduct
  • I have signed off my commits with git commit --signoff (DCO compliance)
  • I have signed my commits with my SSH or GPG key (git commit -S)
  • My commit messages follow the required format: <gitmoji>(type) title description
  • I have added a changelog entry under ## [Unreleased] section (if noticeable change)
  • I have added corresponding tests for new features or bug fixes (if applicable) - N/A for CI workflow
Add workflow_dispatch-triggered workflow that builds and pushes images
to GitHub Container Registry (ghcr.io). This allows forked repositories
to build their own images for testing without requiring Docker Hub
credentials.

Images are tagged with branch names, semver tags, and commit SHA for
easy testing of specific builds.

Signed-off-by: dtinth on MBP M1 <dtinth@spacet.me>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

1 participant