We keep a ChangeLog. Read it before upgrading.
Ihatemoney follows semantic versioning. So minor/patch upgrades can be done blindly.
(sufficient for minor/patch upgrades)
From the virtualenv (if any):
pip install -U ihatemoney
Restart supervisor, or Apache, depending on your setup.
You may also want to set new configuration variables (if any). They are mentioned in the ChangeLog, but this is not required for minor/patch upgrades, a safe default will be used automatically.
(must read for major upgrades)
When upgrading from a major version to another, you must follow special instructions:
2.x → 3.x¶
Sentry support has been removed. Sorry if you used it.
Appart from that, General procedure applies.
1.x → 2.x¶
Switch from git installation to pip installation¶
The recommended installation method is now using pip. Git is now intended for development only.
Be extra careful to not remove your sqlite database nor your settings file, if they are stored inside the cloned folder.
- Delete the cloned folder
If you are using a virtualenv, then the following commands should be run inside it (see Prepare virtualenv (recommended)).
Install ihatemoney with pip:
pip install ihatemoney
Fix your configuration file (paths have changed), depending on the software you use in your setup:
ihatemoney generate-config gunicorn.conf.py(nothing critical changed, keeping your old config might be fine)
- supervisor :
ihatemoney generate-config supervisord.conf(mind the
ihatemoney generate-config apache-vhost.conf(mind the
Restart Apache or Supervisor, depending on your setup.
Upgrade ADMIN_PASSWORD to its hashed form¶
Not required if you are not using the ADMIN_PASSWORD feature.
ihatemoney generate_password_hashwill do the hashing job for you, just put
- its result in the
ADMIN_PASSWORDvar from your ihatemoney.cfg and restart apache or the supervisor job.