README

Wallos: Open-Source Personal Subscription Tracker

  
  
  
  
  



 Table of Contents

- Introduction
- Features
- Demo
- Getting Started
  - Prerequisites
    - Baremetal
    - Docker
  - Installation
    - Baremetal
      - Updating
    - Docker
    - Docker-Compose
- Usage
- Screenshots
- OIDC
- AI Recommendations
- API Documentation
- Contributing
  - Contributors
  - Translations
- License
- Links

 Introduction

Wallos is a powerful, open-source, and self-hostable web application designed to empower you in managing your finances with ease. Say goodbye to complicated spreadsheets and expensive financial software – Wallos simplifies the process of tracking expenses and helps you gain better control over your financial life.

 Features

- Subscription Management: Keep track of your recurring subscriptions and payments, ensuring you never miss a due date.
- Category Management: Organize your expenses into customizable categories, enabling you to gain insights into your spending habits.
- Multi-Currency support: Wallos supports multiple currencies, allowing you to manage your finances in the currency of your choice.
- Currency Conversion: Integrates with the Fixer API so you can get exchange rates and see all your subscriptions on your main currency.
- Data Privacy: As a self-hosted application, Wallos ensures that your financial data remains private and secure on your own server.
- Customization: Tailor Wallos to your needs with customizable categories, currencies, themes and other display options.
- Sorting Options: Allowing you to view your subscriptions from different perspectives.
- Logo Search: Wallos can search the web for the logo of your subscriptions if you don't have them available for upload.
- Mobile view: Wallos on the go.
- Statistics: Another perspective into your spendings.
- Notifications:  Wallos supports multiple notification methods (email, discord, pushover, telegram, gotify and webhooks). Get notified about your upcoming payments.
- Multi Language support.
- OIDC with OAuth
- AI Recommendations with ChatGPT, Gemini, OpenRouter, a local Ollama or any OpenAI-compatible API

 Demo

If you want to try Wallos, a demo is available at https://demo.wallosapp.com.  
The database is reset every 2 hours.  
To access the demo use the following credentials:

python
Username: demo  
Password: demo


 Getting Started

See instructions to run Wallos below.

 Prerequisites

 Baremetal

- NGINX or APACHE websever running
- PHP 8.3 with the following modules enabled:
    - curl
    - dom
    - gd
    - intl
    - openssl
    - sqlite3
    - zip
    - mbstring
    - fpm

 Docker

- Docker

 Installation

 Baremetal

1. Download or clone this repo and move the files into your web root - usually /var/www/html
2. Rename /db/wallos.empty.db to /db/wallos.db
3. Open the app in your browser — migrations run automatically on the registration page
4. A

Top issues

Discussions

Latest release

5.11.1 (2026-11-07)


 Bug Fixes

 escape folder names on output and let the Telegram test use the instance bot (259b12e)