mirror of
https://github.com/firefly-iii/firefly-iii.git
synced 2025-02-20 11:48:27 -06:00
90 lines
6.1 KiB
Markdown
90 lines
6.1 KiB
Markdown
# Firefly III: A personal finances manager
|
||
|
||
[](https://secure.php.net/downloads.php) [](https://packagist.org/packages/grumpydictator/firefly-iii) [](https://www.gnu.org/licenses/gpl.html) [](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=44UKUT455HUFA)
|
||
|
||
[](https://firefly-iii.org/static/screenshots/4.6.12/index.png) [](https://firefly-iii.org/static/screenshots/4.6.12/account.png)
|
||
|
||
[](https://firefly-iii.org/static/screenshots/4.6.12/budget.png) [](https://firefly-iii.org/static/screenshots/4.6.12/category.png)
|
||
|
||
[](https://firefly-iii.org/static/screenshots/4.6.12/report1.png) [](https://firefly-iii.org/static/screenshots/4.6.12/report2.png)
|
||
|
||
"Firefly III" is a financial manager for your personal finances. It can help you keep track of your expenses and income.
|
||
Firefly III supports the use of budgets. You can categorize and tag your transactions.
|
||
It also supports credit cards, shared household accounts and savings accounts.
|
||
There are many financial reports available.
|
||
|
||
## Want to try Firefly III?
|
||
|
||
There is a **[demo site](https://demo.firefly-iii.org)** with an example financial administration already present. You can use Docker, Heroku or Sandstorm.io (see below) to quickly setup your own instance.
|
||
|
||
## Install Firefly III
|
||
|
||
### Using docker
|
||
|
||
You can use docker-compose to [set up your personal secure](https://firefly-iii.org/using-docker.html) Firefly III environment. Advanced users can use the Dockerfile directly.
|
||
|
||
### Using vagrant (or other VMs)
|
||
|
||
You can install Firefly III on any Linux or Windows machine. You'll need a web server (preferrably on Linux) and access to the command line. Please read the [installation guide](https://firefly-iii.org/using-installing.html).
|
||
|
||
### Using Heroku
|
||
|
||
[](https://heroku.com/deploy?template=https://github.com/firefly-iii/firefly-iii/tree/master)
|
||
|
||
Register for a free Heroku account and instantly run Firefly III on your very own cloud instance.
|
||
|
||
### Using Sandstorm.io
|
||
|
||
You can find Firefly III in [the Sandstorm.io marketplace](https://apps.sandstorm.io/app/uws252ya9mep4t77tevn85333xzsgrpgth8q4y1rhknn1hammw70). You can run it on your own installation or on Oasis.
|
||
|
||
### Other options
|
||
|
||
Firefly III is also available as a package on [Softaculous](https://softaculous.com/) and [AMPPS](https://www.ampps.com/).
|
||
|
||
## More about Firefly III
|
||
|
||
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 works on the principle that if you know where you're money is going, you can stop it from going there.
|
||
|
||
### Some advantages of using Firefly
|
||
|
||
- Firefly can import any CSV file, so migrating from other systems is easy.
|
||
- Firefly runs on your own server, so you are fully in control of your data. Remember, there is no such thing as "the cloud", it’s just somebody else’s computer!
|
||
- Firefly has lots of features without being fancy or bloated.
|
||
- If you feel you're missing something you can just ask me and I'll add it!
|
||
|
||
Firefly III has become pretty awesome over the years! (but please excuse me for bragging, it's just that I'm proud of it).
|
||
[You can read more about Firefly III, and its features, on the website](https://firefly-iii.org/).
|
||
|
||
### Contributing
|
||
|
||
Please read [CONTRIBUTING.md](https://github.com/firefly-iii/firefly-iii/blob/master/.github/CONTRIBUTING.md) for details on contributing, and the process for submitting pull requests. Please check out the [code of conduct](https://github.com/firefly-iii/firefly-iii/blob/master/CODE_OF_CONDUCT.md) as well.
|
||
|
||
### Versioning
|
||
|
||
We use [SemVer](http://semver.org/) for versioning. For the versions available, see [the tags](https://github.com/firefly-iii/firefly-iii/tags) on this repository.
|
||
|
||
### Authors
|
||
|
||
* James Cole
|
||
* Over time, [many people have contributed to Firefly III](https://github.com/firefly-iii/firefly-iii/graphs/contributors).
|
||
|
||
### License
|
||
|
||
This work [is licensed](https://github.com/firefly-iii/firefly-iii/blob/master/LICENSE) under the [GPL v3](https://www.gnu.org/licenses/gpl.html).
|
||
|
||
### Other stuff
|
||
|
||
If you like Firefly III and if it helps you save lots of money, why not send me [a dime for every dollar saved](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=44UKUT455HUFA) (this is a joke, although the Paypal form works just fine, try it!)
|
||
|
||
If you want to contact me, please open an issue or [email me](mailto:thegrumpydictator@gmail.com).
|
||
|
||
### Alternatives
|
||
|
||
If you are looking for alternatives, check out [Kickball's Awesome-Selfhosted list](https://github.com/Kickball/awesome-selfhosted) which features not only Firefly III but also noteworthy alternatives such as [Silverstrike](https://github.com/agstrike/silverstrike).
|
||
|
||
[](https://travis-ci.org/firefly-iii/firefly-iii) [](https://scrutinizer-ci.com/g/firefly-iii/firefly-iii/?branch=master) [](https://coveralls.io/github/firefly-iii/firefly-iii?branch=master)
|