GitDeployHub

barryvdh/firefly-iii

github.com/barryvdh/firefly-iii ↗
Node.js API
20 environment variables found in .env.example

Set these on your host before deploying. Each platform has an “Environment Variables” section in the deploy flow. (showing first 20, more exist in .env.example)

  • APP_ENV You can leave this on "local". If you change it to production most console commands will ask for extra confirmation. Never set it to…
  • APP_DEBUG Set to true if you want to see debug information in error screens.
  • SITE_OWNER This should be your email address. If you use Docker or similar, you can set this variable from a file by using SITE_OWNER_FILE The…
  • APP_KEY secret The encryption key for your sessions. Keep this very secure. Change it to a string of exactly 32 chars or use something like `php artisan…
  • DEFAULT_LANGUAGE Firefly III will launch using this language (for new users and unauthenticated visitors) For a list of available languages:…
  • DEFAULT_LOCALE The locale defines how numbers are formatted. by default this value is the same as whatever the language is.
  • TZ Change this value to your preferred time zone. Example: Europe/Amsterdam For a list of supported time zones, see…
  • TRUSTED_PROXIES TRUSTED_PROXIES is a useful variable when using Docker and/or a reverse proxy. Set it to ** and reverse proxies work just fine.
  • LOG_CHANNEL The log channel defines where your log entries go to. Several other options exist. You can use 'single' for one big fat error log (not…
  • APP_LOG_LEVEL Log level. You can set this from least severe to most severe: debug, info, notice, warning, error, critical, alert, emergency If you set it…
  • AUDIT_LOG_LEVEL Audit log level. The audit log is used to log notable Firefly III events on a separate channel. These log entries may contain sensitive…
  • AUDIT_LOG_CHANNEL If you want, you can redirect the audit logs to another channel. Set 'audit_stdout', 'audit_syslog', 'audit_errorlog' to log to the system…
  • PAPERTRAIL_HOST Used when logging to papertrail: Also used when audit logs log to papertrail:
  • PAPERTRAIL_PORT
  • DB_CONNECTION Database credentials. Make sure the database exists. I recommend a dedicated user for Firefly III For other database types, please see the…
  • DB_HOST
  • DB_PORT
  • DB_DATABASE
  • DB_USERNAME
  • DB_PASSWORD secret
Alternative Fly.io Anything Dockerized — requires the Fly CLI.
macOS
brew install flyctl && fly launch --from https://github.com/barryvdh/firefly-iii
Linux
curl -L https://fly.io/install.sh | sh && fly launch --from https://github.com/barryvdh/firefly-iii
Windows (PowerShell)
iwr https://fly.io/install.ps1 -useb | iex; fly launch --from https://github.com/barryvdh/firefly-iii
Or deploy to a different host
← Try another repo