Skip to content

feat: add Firefly III template#885

Open
BinkyTwin wants to merge 2 commits into
Dokploy:canaryfrom
BinkyTwin:codex/add-firefly-iii-template
Open

feat: add Firefly III template#885
BinkyTwin wants to merge 2 commits into
Dokploy:canaryfrom
BinkyTwin:codex/add-firefly-iii-template

Conversation

@BinkyTwin
Copy link
Copy Markdown

/claim #152

Summary

  • add a Firefly III template for self-hosted personal finance management
  • include MariaDB persistence, the Firefly III Data Importer, and the scheduled cron trigger used by the official Docker setup
  • configure Dokploy domains for the main app and importer, generated app/cron secrets, database credentials, timezone, and language

Closes #873.
Refs #152 as a partial template-bounty contribution.

Verification

  • node dedupe-and-sort-meta.js
  • node --import ./build-scripts/node_modules/tsx/dist/loader.mjs build-scripts/validate-template.ts --dir blueprints/firefly-iii
  • node --import ./build-scripts/node_modules/tsx/dist/loader.mjs build-scripts/validate-docker-compose.ts --file blueprints/firefly-iii/docker-compose.yml
  • git diff --check
  • docker compose -f blueprints/firefly-iii/docker-compose.yml config
  • docker manifest inspect fireflyiii/core:version-6.6.2
  • docker manifest inspect fireflyiii/data-importer:version-2.3.2
  • docker manifest inspect mariadb:11.8
  • docker manifest inspect alpine:3.22

Copilot AI review requested due to automatic review settings May 20, 2026 19:43
@dosubot dosubot Bot added size:M This PR changes 30-99 lines, ignoring generated files. template New template request labels May 20, 2026
@BinkyTwin BinkyTwin mentioned this pull request May 20, 2026
@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 20, 2026

built with Refined Cloudflare Pages Action

⚡ Cloudflare Pages Deployment

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

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a new Dokploy blueprint for deploying Firefly III (personal finance manager) with its MariaDB database, the official data importer, and a scheduled cron-trigger container, plus the corresponding metadata entry.

Changes:

  • Added blueprints/firefly-iii/ including docker-compose.yml, template.toml, and a logo asset.
  • Configured Dokploy domains and environment variables (app URL/keys, DB credentials, timezone, language, cron token).
  • Registered the new template in meta.json with links, tags, and version.

Reviewed changes

Copilot reviewed 3 out of 4 changed files in this pull request and generated 2 comments.

File Description
meta.json Adds the firefly-iii entry to the central templates index.
blueprints/firefly-iii/template.toml Defines variables, Dokploy domain routing for app/importer, and environment wiring.
blueprints/firefly-iii/docker-compose.yml Introduces the Firefly III + MariaDB + importer + cron service stack.
blueprints/firefly-iii/firefly-iii.svg Adds the template logo referenced by meta.json.

- 8080
environment:
FIREFLY_III_URL: http://firefly-iii:8080
VANITY_URL: ${APP_URL}
Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Updated in 4860544: VANITY_URL now uses an explicit FIREFLY_III_VANITY_URL env var instead of reusing APP_URL directly.

I kept the default value pointed at the public Firefly III app URL (http://${main_domain}), because the Firefly III data-importer docs describe FIREFLY_III_URL as the internal Docker URL and VANITY_URL as the public URL the importer should use when linking back to Firefly III: https://docs.firefly-iii.org/how-to/data-importer/installation/docker/

Comment thread blueprints/firefly-iii/template.toml
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

🙋 Bounty claim size:M This PR changes 30-99 lines, ignoring generated files. template New template request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Firefly III

2 participants