Having accumulated a considerable amount of debt a few years ago, and in need for a better way of tracking my family finances than using a spreadsheet, I decided to look into building my own solution. I had dabbled in Ruby on Rails briefly before and enjoyed it so took this opportunity to really dive in and build a full featured application. olubalance is constantly growing and I hope if you find it you'll enjoy it as much as I have enjoyed building it!
olubalance is meant to be used as an online checkbook register (remember when people used to "balance their checkbooks"?). The idea is that you enter transactions as you spend or earn and know exactly how much is in your account at any given time.
If you rely on online banking, you can sometimes be surprised when pending transactions post, or that check you wrote 3 weeks ago and forgot about until it's too late. By using olubalance to track your finances, you can mitigate these surprises and stay on track! There is even a feature to mark transactions as pending so that you can keep an eye on those transactions in your regular online banking account. In olubalance, pending transactions are reflected in your account balance (unlike online banking)... yay!
One other fantastic feature is the ability to attach receipts to your transactions. From a mobile device, it's as easy as snapping a photo of your receipt when you create a transaction and it will be saved where it needs to be for future reference. Attachments can be either image files or PDF files (for online bill payments). This is a great way to keep record of where your money goes in case you ever need proof of it in the future.
olubalance cannot and will not ever connect to your bank account. This is unlike other financial tools that "sync" your transactions from your online banking account. With olubalance, you will be the only party to add or remove transactions within the app.
olubalance is free and open source, and licensed under the MIT License. Feel free to build and deploy on your own server as you see fit (I recommend Dokku with the PostgreSQL Plugin)! See the license link for further details regarding terms of use.
Basic instructions for building olubalance on your local system
- Ruby 2.6.4
- Rails 6.0.2.1
- PostgreSQL 12
- ImageMagick
- Your own Amazon S3 Storage Credentials (or change the config to use local storage)
Once dependencies have been met:
- Create Postgres User, set a password
- Run
bundle install
- Save the file
application.yml.sample
toapplication.yml
- Set the configuration values in
application.yml
as you wish - Run
rails db:create
- Run
rails db:migrate
- Run
rails db:seed
if you wish to seed the database with sample data. - Boot up your rails server (
rails s
), and browse tolocalhost:3000
in a web browser!
Feel free to file an issue on the project and I'll do my best to accomodate! :)