Wallos

GPL-3.0
Platform
Docker Self-hosted
Licence
GPL-3.0 Open source
Wallos

Overview

Wallos is a self-hosted web application for tracking recurring subscriptions and what they actually cost. Each subscription carries a price, a billing cycle, a next payment date and a category, and the app presents the whole set as a sortable list, a calendar or a set of statistics — so a pile of small monthly charges stops being invisible.

It is a PHP application on SQLite, shipped as a Docker image (bellamy/wallos) and also installable into a plain NGINX or Apache web root. There is no account on anybody else’s server: the subscription list, the uploaded logos and the payment history live in a database file on your own machine.

Features

  • Subscription entries with cost, currency, billing cycle, next due date and payment method
  • Custom categories, so spending can be grouped and compared instead of read line by line
  • Multi-currency handling with automatic exchange rates from the Fixer API, with everything totalled in your main currency
  • Statistics view over the same data: cost by category, by payment method and across the year
  • Calendar of upcoming payments, plus sorting choices for looking at the list from different angles
  • Logo search that fetches an icon for services you have no image for
  • Payment notifications by email, Discord, Pushover, Telegram, Gotify or a plain webhook
  • OIDC login over OAuth, for people who would rather not keep another local password
  • Optional AI recommendations through ChatGPT, Gemini, OpenRouter, a local Ollama model or any OpenAI-compatible API
  • Light and dark themes, a mobile layout, and a translated interface

Setup

The shortest route is the published container: run bellamy/wallos:latest, bind a host directory on /var/www/html/db for the SQLite file and a second one on /var/www/html/images/uploads/logos if you upload your own icons, set TZ so notification jobs fire at your local hours, and publish container port 80 (the documented example uses 8282 on the host). A compose file ships in the repository.

Running it without Docker needs a web server in front of PHP 8.3 with the curl, dom, gd, intl, openssl and sqlite modules enabled: copy the files into the web root, rename db/wallos.empty.db to db/wallos.db, and add the project’s cron entries for next-payment recalculation, exchange-rate updates and notification delivery. A public demo sits at demo.wallosapp.com with the credentials demo / demo, wiped every two hours.

Who it is for

Anyone whose recurring charges are spread across several cards and currencies and who wants one list of what renews when, without handing the list to a service. Self-hosting keeps a fairly revealing picture of your private life — what you read, watch, host and pay for — on a server you control.

It is a tracker rather than an accounting package: no double-entry ledger, no bank statement import and no invoice generation. Firefly III is the better fit for full personal accounting, and Subscription Manager is the lighter option if all you need is a monthly total. Wallos is GPL-3.0 licensed, has roughly 8,800 stars on GitHub and is actively developed.

Explore More Categories

Sign In

Register

Reset Password

Please enter your username or email address, you will receive a link to create a new password via email.