What is Kresus?
Kresus is a free, open-source, self-hosted personal finance management platform designed to help individuals organize their finances and monitor their bank accounts from a centralized interface.
It automatically retrieves banking transactions, organizes financial activity into categories, and provides charts and reports to help users understand their spending habits.
Kresus uses Woob, an open-source project that provides connectors for retrieving financial information from supported banking websites. This allows users to synchronize their accounts and transactions without relying on a centralized third-party financial management service.
With Kresus, users can monitor account balances, categorize transactions, establish budgets, and keep track of their financial activity while hosting their data on their own infrastructure.
History of Kresus
Kresus is an open-source personal finance management application that originally started as a fork of Cozy PFM.
The project evolved into an independent financial management platform with its own interface, transaction management capabilities, and integration with Woob for banking synchronization.
Its development focuses on providing a self-hosted alternative to commercial personal finance applications, allowing users to maintain control over their financial information.
Kresus is distributed under the GNU Affero General Public License (AGPL).
Key Features of Kresus
Kresus provides several tools for managing personal finances and understanding financial activity.
- Bank Account Synchronization: Retrieve financial information and transactions from supported banking institutions using Woob.
- Centralized Account Management: View multiple bank accounts and their balances from a single interface.
- Automatic Transaction Import: Retrieve new banking transactions periodically without manually importing them.
- Automatic Categorization: Create rules that automatically assign categories to transactions based on their descriptions.
- Transaction Management: Rename, organize, search, and categorize financial operations.
- Budget Management: Establish budgets and monitor spending.
- Financial Charts: Visualize income, expenses, and financial activity through charts.
- Transaction Search: Find operations using dates, amounts, descriptions, and categories.
- Email Notifications: Configure alerts for transactions exceeding specified amounts or account balances reaching defined thresholds.
- Manual Transactions: Add financial operations manually when necessary.
- Data Import: Import supported financial data formats, including OFX.
- Self-Hosted Architecture: Run the application on your own server and maintain control over your financial data.
Use Cases
Kresus is suitable for individuals who want to manage their personal finances through a self-hosted application.
Common use cases include:
- Personal Finance Management: Monitor income, expenses, and account balances.
- Budget Tracking: Establish spending limits and monitor expenses across different categories.
- Bank Account Monitoring: Consolidate information from multiple supported banking institutions.
- Expense Analysis: Identify spending patterns and understand where money is being spent.
- Transaction Organization: Automatically categorize transactions using configurable rules.
- Financial Reporting: Generate visual representations of spending and income over time.
- Privacy-Conscious Finance Management: Store financial information on infrastructure controlled by the user.
- Household Budgeting: Organize financial transactions and monitor shared household expenses.
Benefits of Kresus
- Open-source and self-hosted personal finance management
- Centralized monitoring of multiple bank accounts
- Automatic retrieval of supported banking transactions
- Customizable transaction categorization rules
- Clear financial charts and spending reports
- Searchable transaction history
- Budget management capabilities
- Email notifications for financial events
- Support for importing financial data
- Greater control over personal financial information
- Extensible banking integration through Woob
How to Install Kresus
To install Kresus through Esadax, follow these steps:
- Purchase the application through Esadax.
- After purchasing, you will be prompted to provide the required configuration parameters.
- Enter the requested configuration values.
- Configure the database connection if required by the deployment package.
- Click Deploy to launch the application.
- Access the deployed Kresus interface through its assigned application URL.
- Configure your personal finance management settings.
- Add your supported bank accounts using the available Woob connectors.
- Configure transaction categorization rules and budgets.
- Start monitoring your financial activity through the dashboard.
Once configured, Kresus will periodically retrieve new transactions from connected banking institutions and update your financial information.
Bank Account Synchronization
Kresus uses Woob to communicate with supported banking websites and retrieve financial information.
Woob provides the connectors responsible for interacting with individual banking institutions. Kresus uses these connectors to retrieve account information and transaction history.
The synchronization process generally works as follows:
- Add a banking connection through the Kresus interface.
- Select the corresponding banking institution.
- Provide the required banking credentials.
- Kresus uses the appropriate Woob connector to access the banking website.
- Available account information and transaction history are retrieved.
- New transactions are periodically synchronized.
Kresus normally retrieves new transactions during its scheduled synchronization process, which runs during the night.
Bank compatibility depends on the available Woob connectors. Some institutions may require additional authentication steps, and changes to banking websites can temporarily affect synchronization.
Transaction Management
Kresus provides tools for organizing and managing financial transactions.
Users can review imported operations, update descriptions, assign categories, and search through their financial history.
Transaction management includes:
- Viewing incoming and outgoing transactions
- Editing transaction labels
- Assigning categories
- Searching by date and amount
- Filtering transactions by category
- Adding manual operations
- Reviewing potentially duplicated transactions
- Importing supported transaction files
These capabilities make it easier to maintain an organized financial history and identify spending patterns.
Automatic Transaction Categorization
Kresus supports configurable automatic categorization rules.
Users can create rules that associate transaction descriptions with specific financial categories.
For example, a rule can automatically assign a transaction containing a supermarket name to a groceries category.
Typical categories include:
- Groceries
- Transportation
- Housing
- Utilities
- Healthcare
- Entertainment
- Shopping
- Restaurants
- Taxes
- Income
Categorization rules help reduce repetitive manual work and make financial reports easier to understand.
Users can also manually modify transaction categories when an automatically assigned category is incorrect.
Budget Management and Financial Reports
Kresus provides financial monitoring capabilities that help users understand their spending and manage their budgets.
Its dashboard includes charts that present financial activity according to different criteria.
Available reporting capabilities include:
- Expenses grouped by category
- Income and expenditure comparisons
- Financial activity over time
- Transaction analysis
- Account balance monitoring
Users can establish budgets and review their spending against their financial targets.
These reports make it easier to identify recurring expenses, understand spending trends, and make informed budgeting decisions.
Notifications and Alerts
Kresus supports email notifications for important financial events.
Users can configure alerts based on transaction amounts and account balances.
Examples include:
- Notifications when a transaction exceeds a configured amount
- Alerts when an account balance reaches a specified threshold
- Email reports containing newly retrieved transactions
Email notifications can be useful for monitoring unusual financial activity and keeping track of important account events.
Additional notification integrations can be configured through Apprise when an Apprise API server is available.
Security / Administration / Configuration
Because Kresus handles sensitive financial information and banking credentials, its deployment requires particular attention to security.
Important security considerations include:
- Use strong credentials for application and infrastructure access.
- Protect the application behind an authenticated access layer.
- Enable HTTPS for remote access.
- Restrict access to trusted users and networks.
- Protect banking credentials and configuration files.
- Use encrypted storage for sensitive financial data.
- Keep Kresus and Woob updated.
- Avoid exposing the application port directly to the public internet.
- Configure firewall rules to restrict unnecessary network access.
- Maintain regular backups of financial data and database contents.
Important security consideration: Kresus documentation states that banking credentials and application data are not encrypted at rest in its standalone configuration. Self-hosting does not automatically encrypt sensitive information. Use encrypted storage, secure configuration permissions, and appropriate access controls.
The official Docker deployment documentation also provides a Docker Compose setup with HTTPS and login/password protection through a reverse proxy. Do not assume that an independently deployed instance has equivalent protection unless the Esadax deployment explicitly configures it.
Best Practices for Kresus
- Verify that your banking institution is supported by Woob before configuring synchronization.
- Use a dedicated, secured server for financial management.
- Protect the application with HTTPS and authentication.
- Encrypt persistent storage containing financial information.
- Review automatic categorization rules regularly.
- Organize transactions into meaningful categories.
- Configure budgets according to your financial objectives.
- Review account balances and transaction history periodically.
- Monitor synchronization failures and banking connector updates.
- Back up application data, configuration files, and database contents.
- Restrict access to sensitive financial information.
- Keep Kresus and its dependencies updated.
Configuration Parameters
After purchasing this application on Esadax, you will be prompted to provide the configuration parameters required by the deployment.
Esadax adds the supplied variables to the deployment so the application can be launched with the configuration it requires.
Depending on the deployment package, configuration may include:
| Configuration | Description |
|---|---|
| Database Host | Hostname or address of the PostgreSQL database server. |
| Database Port | Port used for database connections. |
| Database Name | Database used to store Kresus information. |
| Database Username | Account used by Kresus to connect to the database. |
| Database Password | Password associated with the database account. |
| Data Directory | Persistent directory used to store application data. |
| Application Port | Port used to expose the Kresus web interface. |
The official Kresus Docker image also supports the following environment variable:
| Parameter | Description |
|---|---|
LOCAL_USER_ID |
Sets the user ID used by Kresus inside the Docker container to help avoid running the application as root. |
Kresus uses a config.ini configuration file for application settings, including database configuration. Environment variables can also override corresponding configuration file values.
PostgreSQL is the recommended database for production deployments. SQLite is intended primarily for testing and development because of its migration limitations.
The exact configuration parameters depend on the Esadax deployment package. Use the values presented during the purchase and deployment process.
Once the required values are configured, click Deploy to launch Kresus.
Storage and Persistence
Kresus stores financial information, application data, and related configuration in persistent storage.
For Docker deployments, the official pre-built image provides the following important storage locations:
| Path | Description |
|---|---|
/home/user/data |
Stores Kresus application data. |
/woob |
Stores the local Woob installation and banking connectors. |
/opt/config.ini |
Application configuration file. |
The /home/user/data directory should be mounted to persistent storage to prevent losing application data during container restarts or updates.
Database contents and the configuration file must also be included in backup procedures.
For reliable backups, the official documentation recommends stopping Kresus before copying its data directory and database.
Conclusion
Kresus is an open-source, self-hosted personal finance management platform designed to simplify the way individuals monitor and organize their finances.
With automatic banking synchronization through Woob, configurable transaction categorization, budget management, financial charts, and email alerts, it provides a centralized environment for understanding personal financial activity.
Its self-hosted architecture gives users greater control over their financial information, making it a practical solution for individuals who want to manage bank accounts and expenses without relying on a centralized commercial finance management platform.

