PHP HTML Vue Shell Cap'n Proto Ruby
Permalink
Failed to load latest commit information.
.deploy Clean up docker file. Jul 9, 2018
.github Bot cannot close bug tickets [skip ci] Jun 28, 2018
.sandstorm Update config files and change logs for hotfix. Jul 28, 2018
app Fix for #1572 Jul 28, 2018
bootstrap Fix tests Apr 27, 2018
config Update config files and change logs for hotfix. Jul 28, 2018
database Give all of these files a newline at the end. Jul 22, 2018
public Found and fixed #1571 Jul 28, 2018
resources Updated files for 4.7.5.2 Jul 28, 2018
routes Various code cleanup Jul 20, 2018
storage Add file used to test UTF8 check. May 12, 2018
tests Updated files for 4.7.5.2 Jul 28, 2018
.codeclimate.yml Code climate file. Jan 17, 2018
.dockerignore Fix #1541 Jul 9, 2018
.env.docker Extend mail config and help. #1487 Jun 16, 2018
.env.example Extend mail config and help. #1487 Jun 16, 2018
.env.heroku Extend mail config and help. #1487 Jun 16, 2018
.env.sandstorm Extend mail config and help. #1487 Jun 16, 2018
.env.testing Extend mail config and help. #1487 Jun 16, 2018
.gitattributes First step towards Laravel 5.5 Sep 9, 2017
.gitignore Revert "Updated git ignore. (firefly-iii/firefly-iii#1443)" May 25, 2018
.htaccess Add warning message to index. Jan 6, 2018
.scrutinizer.yml Update .scrutinizer.yml Jan 19, 2018
.travis.yml Go for php 7.1.8 to mimic dev machine. Jul 1, 2018
Dockerfile Small update for Sandstorm release. Jul 18, 2018
LICENSE New copyright notice. Oct 21, 2017
Procfile Configure nginx [skip ci] Apr 27, 2017
app.json Update links to new site. Dec 13, 2017
artisan First step towards Laravel 5.5 Sep 9, 2017
changelog.md Update config files and change logs for hotfix. Jul 28, 2018
composer.json Update composer libs. Jun 6, 2018
composer.lock Updated files for 4.7.5.2 Jul 28, 2018
crowdin.yml Add newlines to end of file. Mar 19, 2018
docker-compose.yml Move to MariaDB. [skip ci] #1366 Apr 21, 2018
index.php Add newlines to end of file. Mar 19, 2018
nginx_app.conf Various Heroku related fixes. Nov 29, 2017
package-lock.json Update lock files Feb 6, 2018
package.json Remove unused dependencies Feb 6, 2018
phpunit.coverage.specific.xml Update test code. Jul 1, 2018
phpunit.coverage.xml Update test code. Jul 1, 2018
phpunit.xml Fix tests Apr 27, 2018
readme.md Small update for Sandstorm release. Jul 18, 2018
server.php Add newlines to end of file. Mar 19, 2018
test.sh Call test at wrong position [skip ci] Apr 21, 2018
webpack.mix.js Remove unused dependencies Feb 6, 2018

readme.md

Firefly III

Packagist License Donate

Introduction

"Firefly III" is a (self-hosted) manager for your personal finances. It can help you keep track of your expenses and income, so you can spend less and save more. Firefly III supports the use of budgets, categories and tags. It can import data from external sources and it has many neat financial reports available. Here are some screenshots:

The index of Firefly III The account overview of Firefly III

Overview of all budgets Overview of a category

Purpose

Personal financial management is pretty difficult, and everybody has their own approach to it. Some people make budgets, other people limit their cashflow by throwing away their credit cards, others try to increase their current cashflow. There are tons of ways to save and earn money. Firefly III works on the principle that if you know where you're money is going, you can stop it from going there.

By keeping track of your expenses and your income you can budget accordingly and save money. Stop living from paycheck to paycheck but give yourself the financial wiggle room you need.

You can read more about this in the official documentation.

Features

Most importantly...

  • Firefly III runs on your own server, so you are fully in control of your data. It will not contact other sites or servers.
  • You can import from over 2500 financial providers, in 55 countries when you enable the Spectre API.
  • You can import from bunq.
  • You can import CSV files from practically any bank.
  • Firefly III features an JSON REST API.
  • If you feel you’re missing something you can just ask me and I’ll add it!

But actually, it features:

Everything is organised:

  • Clear views that should show you how you're doing
  • Easy navigation through your records
  • Browse back and forth to see previous months or even years
  • Lots of charts because we all love them
  • Financial reporting showing you how well you are doing
  • Lots of math because we all like math!

Who is it for?

This application is for people who want to track their finances, keep an eye on their money without having to upload their financial records to the cloud. You're a bit tech-savvy, you like open source software and you don't mind tinkering with (self-hosted) servers.

Get started

There are many ways to run Firefly III

  1. There is a demo site with an example financial administration already present.
  2. You can install it on your server.
  3. You can run it using Docker.
  4. You can deploy to Heroku
  5. You can deploy to Sandstorm.io
  6. You can install it using Softaculous. These guys even have made another demo site!
  7. You can install it using AMPPS
  8. You can install it with YunoHost.
  9. Even more options are on the way!

Update your instance

Make sure you check for updates regularly. Your Firefly III instance will ask you to do this. Upgrade instructions can be found in the official documentation.

Contribute

Your help is always welcome! Feel free to open issues, ask questions, talk about it and discuss this tool. I've create several social media accounts and I invite you to follow them, tweet at them and post to them. There's reddit, Twitter and Facebook just to start. It's not very active but it's a start!

Of course there are some contributing guidelines and a code of conduct, which I invite you to check out.

I can always use your help squashing bugs, thinking about new features or translating Firefly III into other languages.

For all other contributions, see below.

The goal

Firefly III should give you insight into and control over your finances. Money should be useful, not scary. You should be able to see where it is going, to feel your expenses and to... wow, I'm going overboard with this aren't I?

But you get the idea: this is your money. These are your expenses. Stop them from controlling you. I built this tool because I started to dislike money. Having it, not having, paying bills with it, etc. But no more. I want to feel "safe", whatever my balance is. And I hoop this tool can help. I know it helps me.

Contact

You can contact me at thegrumpydictator@gmail.com, you may open an issue or contact me through the various social media pages there are: reddit, Twitter and Facebook.

Over time, many people have contributed to Firefly III.

Other stuff

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

License

This work is licensed under the GPL v3.

Donate

If you like Firefly III and if it helps you save lots of money, why not send me a dime for every dollar saved!

OK that was a joke. Thank you for considering donating to Firefly III! Please checkout my Patreon page or visit PayPal.

Alternatives

If you are looking for alternatives, check out Kickball's Awesome-Selfhosted list which features not only Firefly III but also noteworthy alternatives such as Silverstrike.

Badges

I like badges!

Travis branch Scrutinizer Coveralls github branch Requires PHP7.1 license Patreon page