Skip to content

Add Billmora template#773

Open
Nekoplii wants to merge 12 commits intoDokploy:canaryfrom
Nekoplii:template/billmora
Open

Add Billmora template#773
Nekoplii wants to merge 12 commits intoDokploy:canaryfrom
Nekoplii:template/billmora

Conversation

@Nekoplii
Copy link
Copy Markdown

@Nekoplii Nekoplii commented Apr 5, 2026

What is this PR about?

This PR introduces a new template for Billmora.
Billmora (Billing Management, Operation, and Recurring Automation) is a free, open-source platform tailored for hosting providers to easily manage clients, invoicing, and automated server provisioning.

Template details:

  • Deploys the main Billmora web application (billmora-app).
  • Configures a MariaDB database container alongside a Redis container to handle cache, sessions, and queues.
  • Includes dedicated sidecar containers for the Queue Worker (billmora-worker) and Cron Scheduler (billmora-scheduler) to ensure background tasks and automated provisioning run reliably.
  • Sets up persistent volumes for the database, Redis data, and shared Laravel local storage (mounted across the app, worker, and scheduler instances).
  • Automatically manages required environment variables (e.g., APP_KEY, passwords for DB/Redis, URL) using Dokploy's dynamic variables.

Checklist

Before submitting this PR, please make sure that:

Screenshots or Videos

image image image

Greptile Summary

This PR adds a new Billmora template that deploys the Billmora billing/invoicing platform with a MariaDB database, Redis cache, a queue worker sidecar, and a cron scheduler sidecar. The overall architecture is well-structured — healthcheck conditions on depends_on, shared billmora-storage volume across all three app containers, auto-generated secrets via Dokploy's variable helpers, and AUTORUN_ENABLED=false correctly set on the worker/scheduler to prevent duplicate migrations.

However, there are a few issues that need to be resolved before merging:

  • The links field in meta.json uses an array format instead of the object format used by every other entry in the repository — this will fail CI schema validation and is a required fix.
  • Tags are not lowercase, inconsistent with the project convention.
  • Docker images are pinned to latest rather than a specific release version, which is flagged by the AGENTS.md guide as a security concern.

Confidence Score: 2/5

Not safe to merge — the links array format in meta.json will fail CI schema validation.

Score of 2 reflects the P0 links format issue that will cause a structural validation failure in CI. The template logic itself is sound and well-implemented, but the metadata inconsistency is a blocking issue that must be corrected before the PR can be merged.

meta.json requires the most attention — the links and tags fields both need correction. blueprints/billmora/docker-compose.yml should also have image tags pinned to a specific version.

Reviews (1): Last reviewed commit: "refactor(billmora): remove APP_TIMEZONE ..." | Re-trigger Greptile

Greptile also left 3 inline comments on this PR.

(2/5) Greptile learns from your feedback when you react with thumbs up/down!

Context used:

  • Context used - AGENTS.md (source)

@dosubot dosubot bot added size:L This PR changes 100-499 lines, ignoring generated files. template New template request labels Apr 5, 2026
@github-actions
Copy link
Copy Markdown

github-actions bot commented Apr 5, 2026

built with Refined Cloudflare Pages Action

⚡ Cloudflare Pages Deployment

Name Status Preview Last Commit
templates ✅ Ready (View Log) Visit Preview cdfd442

Comment thread meta.json Outdated
Comment thread meta.json Outdated
Comment thread blueprints/billmora/docker-compose.yml
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size:L This PR changes 100-499 lines, ignoring generated files. template New template request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant