Multi-Currency Support #

Econumo offers multi-currency functionality. To get started, you need to:

1. Load currencies into your Econumo instance.
2. Set up a daily update for exchange rates (if needed).

How to add a new currency to Econumo #

If you want to use a currency other than USD (the only preloaded currency in Econumo), simply run the following command (available since v0.5.1):

docker-compose exec -u www-data econumo bin/console app:add-currency --help

If you want to add multiple currencies and require regular exchange rate updates, see the next step.

How to add currencies and update exchange rates #

To simplify the process of adding currencies and updating their exchange rates, we have developed a tool that uses data from Open Exchange Rates to update currencies and exchange rates.

You can find the tool and its documentation here: https://github.com/econumo/currency-loader

Please, not that Base currency is not your default currency. It is only used for conversions.

For example: If you have most of your accounts in CAD (Canadian Dollar) and one savings account in USD and one in EUR. The currency conversion will occur in two scenarios:

1. When you transfer money from your CAD account to your USD/EUR accounts.
2. In your budget, if you choose to convert spending to other currencies.

Econumo will use the following conversions:

1. CAD ↔ USD directly.
2. CAD → USD (base) → EUR and EUR → USD (base) → CAD

Typically, conversions using the base currency show minimal or no difference compared to direct conversions.

Using Other Sources #

Alternatively, you can use other sources for currencies and their exchange rates. To do so, you must:

1. Enable the Econumo System API by configuring its API Key.
2. Choose the base currency for exchange conversions and provide it as an environment variable ECONUMO_CURRENCY_BASE ( for example, USD).
3. Use /api/v1/system/import-currency-list to create currencies in Econumo.
4. Use /api/v1/system/import-currency-rates to upload exchange rates.