Freenary is an open-source personal finance app that you host yourself. It connects to your banks through a bank provider (Powens or Enable Banking), imports your accounts and transactions, puts them into categories, and shows a budget. An optional assistant answers questions about your money. Your data stays in your own PostgreSQL database.
You need Docker with Compose v2 and a Unix shell (on Windows, a WSL 2 terminal).
mkdir -p ~/freenary && cd ~/freenary
curl -fsSLo docker-compose.yml https://raw.githubusercontent.com/suiramdev/freenary/main/docker-compose.yml
cat > .env <<EOF
POSTGRES_PASSWORD=$(openssl rand -hex 16)
BETTER_AUTH_SECRET=$(openssl rand -hex 32)
EOF
docker compose up -d --waitOpen http://localhost:3001 and create the first account: it becomes the operator.
The full tutorial, with checks after each step and fixes for common errors, is Get it running. To run Freenary under your own domain with HTTPS, follow Self-host on a server.
All documentation is in docs/:
- Tutorials: Get it running, Self-host on a server, Connect your first bank
- How-to guides: install another way, configure banks, email, sign-in, the assistant and categorisation, update, back up, troubleshoot
- Reference: configuration, Compose files, images, commands, API
- Explanation: architecture, first run, settings, sign-in and email, assistant, categorisation
For AI tools: docs/llms.txt and AGENTS.md.
Read .github/CONTRIBUTING.md. Pull requests target dev.
Report a problem or request a feature in GitHub Issues.
Freenary is free software under the GNU Affero General Public License v3.0 or later. If you change Freenary and let other people use it over a network, you must offer them the source of your version. Third-party notices: THIRD-PARTY-NOTICES.md.
Copyright (C) 2026 Marius (@suiramdev) and the Freenary contributors.