Repolode
ellite

ellite/Wallos

Self-hostable web app for tracking recurring subscriptions, budgets and expenses with multi-currency support and notifications.

Open-source alternative to:Rocket MoneyTruebill

Stars
8,719
Forks
447
Open issues
81
Last commit
2 days ago

What is it?

Wallos is a self-hosted web application for keeping track of recurring subscriptions and payments. It lets you record each subscription with its billing cycle and next payment date, organize spending into custom categories, and view totals through a dashboard, statistics page and calendar.

The app supports multiple currencies and can convert them to a main currency using exchange rates from the Fixer API. Notifications can be sent by email, Discord, Pushover, Telegram, Gotify or webhooks. Optional AI recommendations can use ChatGPT, Gemini or a local Ollama model, and login can be integrated with OIDC/OAuth providers.

Wallos runs on a PHP web server with SQLite storage or as a Docker container. Data stays on your own server, and the project provides an API along with multi-language support and light and dark themes.

Key features

  • 01Track recurring subscriptions with next payment dates and due-date reminders.
  • 02Organize expenses into customizable categories and view statistics and a calendar.
  • 03Manage multiple currencies and convert them to a main currency via Fixer exchange rates.
  • 04Send notifications through email, Discord, Pushover, Telegram, Gotify or webhooks.
  • 05Log in with OIDC/OAuth providers, configurable through the admin page or environment variables.
  • 06Run with Docker or on a bare-metal PHP and web server setup.

Use cases

  • Keeping an overview of streaming, software and other monthly subscriptions for a household.
  • Checking how much recurring spending adds up to across several currencies.
  • Getting reminders before subscriptions renew so payments are not missed.
  • Hosting a private expense tracker on a home server instead of using a cloud service.

Quick start

  1. 1

    Run the Docker container with the README command

    docker run -d --name wallos -v /path/to/config/wallos/db:/var/www/html/db -v /path/to/config/wallos/logos:/var/www/html/images/uploads/logos -e TZ=Europe/Berlin -p 8282:80 --restart unless-stopped bellamy/wallos:latest
  2. 2

    Open the app in your browser at the mapped port and create a user account

Things to know

  • Self-hosting requires running your own server or container.
  • Currency conversion needs a Fixer API key, which has a free tier with limits.

Topics

FAQ

What is Wallos?
Self-hostable web app for tracking recurring subscriptions, budgets and expenses with multi-currency support and notifications. Wallos is a self-hosted web application for keeping track of recurring subscriptions and payments. It lets you record each subscription with its billing cycle and next payment date, organize spending into custom categories, and view totals through a dashboard, statistics page and calendar.
Is Wallos free to use? What license does it have?
Wallos is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.
Is Wallos still maintained?
Actively maintained. The last commit to Wallos was on Oct 19, 2026.
What can I use Wallos for?
Keeping an overview of streaming, software and other monthly subscriptions for a household. Checking how much recurring spending adds up to across several currencies. Getting reminders before subscriptions renew so payments are not missed. Hosting a private expense tracker on a home server instead of using a cloud service.
How do I install Wallos?
Run the Docker container with the README command: docker run -d --name wallos -v /path/to/config/wallos/db:/var/www/html/db -v /path/to/config/wallos/logos:/var/www/html/images/uploads/logos -e TZ=Europe/Berlin -p 8282:80 --restart unless-stopped bellamy/wallos:latest Open the app in your browser at the mapped port and create a user account
Where can I get Wallos?
The source code and installation instructions are on GitHub: https://github.com/ellite/Wallos

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects