firefly-iii — Launchfile Catalog

Run locally

Tested and verified to launch successfully.

Terminal

$ npx launchfile up firefly-iii

Requires Docker Desktop. No source code needed — pulls pre-built images and starts firefly-iii with all dependencies.

Terminal

# Clone the source and run natively
$ git clone https://github.com/firefly-iii/firefly-iii
$ cd firefly-iii
$ npx launchfile up --native

For local development. Requires macOS + Homebrew. Clones the source, installs runtimes and databases via Homebrew, and runs the app natively — no containers.

Image: fireflyiii/core:latest

Launchfile View on GitHub

# yaml-language-server: $schema=https://launchfile.dev/schema/v1
version: launch/v1
name: firefly-iii
description: "Personal finance manager with budgeting and reporting"
repository: https://github.com/firefly-iii/firefly-iii
website: https://firefly-iii.org
logo: https://raw.githubusercontent.com/firefly-iii/firefly-iii/main/public/v1/images/logo.svg

image: fireflyiii/core:latest
provides:
  - protocol: http
    port: 8080
    exposed: true
requires:
  - type: postgres
    set_env:
      DB_CONNECTION: "pgsql"
      DB_HOST: $host
      DB_PORT: $port
      DB_DATABASE: $name
      DB_USERNAME: $user
      DB_PASSWORD: $password
secrets:
  app-key:
    generator: secret
env:
  APP_KEY: "base64:${secrets.app-key|base64}"
  APP_URL:
    default: $app.url
    description: "Public URL Firefly III is reachable on (used in emails, OAuth, links)"
health: /login
storage:
  uploads:
    path: /var/www/html/storage/upload
    persistent: true
restart: always