In this release we made bank sync extensible: a plugin can now act as a bank provider and sync accounts, transactions, card bills and holdings through the same pipeline as Pluggy, Enable Banking and SimpleFIN, and new bank integrations will be built this way from now on. We also show the reserved balances a bank reports inside an account (Mercado Pago cofrinhos and caixinhas, for example) without adding them to your balance, record stock splits in the holding ledger, show the price history of linked recurring charges, and add Hebrew with a right-to-left layout and the Israeli New Shekel. Attachments can now live in an S3-compatible bucket. On the fixes side, every install now gets a secret key of its own instead of a public default, disconnecting a bank keeps its accounts and history, and a rate-limited account no longer stops the rest of a bank sync.
For the next month we are setting new features aside and working through bugs and fixes, with the goal of raising Securo's quality well beyond where it is today. If something is broken or rough for you, now is the best time to open an issue.
☕ If Securo already helps you today, consider supporting it. Buy us a coffee
Before you update
- If your install never set its own
SECRET_KEY(or still useschange-me-in-productionordev-secret-change-in-production), Securo now generates a unique key on the first start and keeps it in the database. Everyone is signed out once, and reset or verification links sent before the update stop working. Bank credentials, LLM keys and plugin secrets keep working: they are re-encrypted under the new key. - External MCP tokens created without your own
AGENTS_MCP_JWT_SECRETstop working, since they were signed with a public key. Create a new one under Agents > Connections > External MCP access. - To roll back to v0.19.x after updating, first set
SECRET_KEYto the value in theinstance_secretstable, or saved credentials won't open.
Features
- Bank sync providers can be plugins. A plugin that provides a bank syncs as a connected bank, with accounts, transactions, card bills and holdings written by the core sync pipeline. Like every plugin with code, it needs the plugin runner, which is off by default: see Plugins with code to turn it on with Docker Compose (the Helm chart does not ship the runner yet). For authors, see the bank provider plugin guide and the demo bank example. Closes #1461, by @fredson-sumi (#1464, #1515, #1516, #1518) 🎉
- Reserved balances from Pluggy (Mercado Pago cofrinhos, caixinhas) are listed on the account, never added to its balance or net worth. Bank plugins can report them too. Closes #1512, by @caioeverest (#1507, #1517) 🎉
- Stock splits in the holding ledger, so a split no longer leaves a position valued at a fraction of its worth. Closes #944, by @APenalba (#1335) 🎉
- Price-change history for linked recurring charges. By @JuizSpeaking (#1376) 🎉
- Hebrew, with a right-to-left layout, and the Israeli New Shekel (ILS). By @barcesat (#1443, #1444) 🎉
- Plugin icons in the catalog, served by your own Securo. Closes #1462, by @fredson-sumi (#1502) 🎉
- Attachments in an S3-compatible bucket (AWS S3, MinIO, Garage and others) with
STORAGE_PROVIDER=s3. Local storage stays the default. (#1494, #1496) - MCP tools to create and edit manual accounts. Closes #1419, by @tiagoflino (#1420) 🎉
- MCP tools to create, update and merge payees. Closes #1261, by @H4ad (#1299) 🎉
- The backend can serve the built frontend with
FRONTEND_DIST_PATH, off by default. Based on #712 by @jrvidotti (#1482, #1483) 🎉
Fixes
- Installs without their own
SECRET_KEYsigned sessions with a public key; each install now gets a unique one, and the MCP server refuses a public signing key. Fixes #1173, closes #1174 (#1467, #1478) /2fa/setupcould replace the TOTP secret while 2FA was on. Closes #1447, by @mccalpink (#1453) 🎉- Disconnecting a bank deleted its accounts and history; they are now kept by default. Refs #1018 (#1469)
- One rate-limited account stopped the whole bank sync; the rest now syncs and the limited account backs off. Closes #1054, #805 (#1297)
- Foreign-currency rows without an exchange rate counted 1:1 in balances. Closes #1263, by @H4ad (#1302) 🎉
- The CSV export did not neutralise spreadsheet formulas. Fixes #1448 (#1475)
- An agent could call tools outside its tool list. Fixes #1463 (#1468)
- Amounts with comma decimals lost their cents in the recurring form. Closes #1072 (#1506)
- Invoice PDFs failed when the number held non-Latin characters or quotes. Fixes #1456 (#1503)
- Bank sync kept a stale description after the provider enriched a pending row. Closes #1432, by @tiagoflino (#1433) 🎉
- An Enable Banking row whose remittance text changed was imported again. By @DVerdeV (#1430) 🎉
- An invalid LLM connection URL was accepted on save. By @davigiroux (#1485) 🎉
- CSV dates followed by a time were rejected. By @jayhemnani9910 (#1431) 🎉
- Quicken QIF dates with a space-padded year were rejected. By @jayhemnani9910 (#1437) 🎉
- Rule errors did not say which field or operator was rejected. Fixes #1499 (#1505)
- A missing attachment file answered 500 instead of 404. (#1498)
- An overlong plugin icon dropped the whole plugin, and the plugin copy now says a manager can also install a plugin with code. (#1521, #1523, #1529)
Under the hood
Migrations back to one head (#1489, #1490) · architecture decision records and an AGENTS.md feature map (#1470, #1472, #1495, #1509, #1528) · tests that guard the workspace boundary and the migrations (#1471) · TOTP clock pinned through pyotp (#1491) · less noise from the test run, by @Kernelkun (#1455) 🎉 · backend suite in four parallel shards (#1473) · CI fast lane, stale queue, read-only token and fork run approvals (#1476, #1477, #1480, #1486, #1493, #1497, #1501, #1504, #1508, #1511, #1524) · CURRENCIES moved to lib/currencies (#1500) · committed test artifacts dropped (#1510) · dependency updates, including vitest 5 (#979, #1206, #1452) · release v0.20.0 (#1576)
Thanks @fredson-sumi, @caioeverest, @APenalba, @JuizSpeaking, @barcesat, @tiagoflino, @H4ad, @mccalpink, @DVerdeV, @davigiroux, @jayhemnani9910, @Kernelkun, @jrvidotti for the code and the reviews, and @mantovanig, @soldier99, @czanette, @shivanisrivastava-01, @zunami, @0xGenesi, @pcampos-infra, @yonicsurny, @Baltair, @ayushi2577 for the reports 💜
☕ Securo has no ads, no tracking and no data to sell. It keeps going because the people who use it chip in. If it helps you with your money every month, buy us a coffee and help keep it alive.
Full Changelog: v0.19.0...v0.20.0