Wallos is an open-source, self-hosted web application designed to help individuals track recurring subscriptions and manage personal finances without relying on third-party services. Built with PHP and designed for simplicity, it eliminates the need for expensive financial software or exposed cloud-based budgeting tools by giving users full control over their financial data. Whether you’re managing a few monthly subscriptions or tracking expenses across multiple currencies, Wallos provides an intuitive interface to visualize spending, set up notifications for upcoming payments, and maintain privacy through local hosting.
Ideal for tech-savvy individuals, privacy-conscious users, and those looking to cut unnecessary recurring charges, Wallos offers a lightweight alternative to commercial finance apps. With built-in support for Docker and bare metal deployment, it integrates seamlessly into existing home server setups while offering advanced features like currency conversion via Fixer API, AI-driven recommendations, and multi-user household support.
What You Get
- Subscription Management - Track all recurring payments with due dates, amounts, and statuses; manually add or import subscriptions to avoid unexpected charges.
- Multi-Currency Support & Conversion - Manage expenses in any currency with real-time exchange rates via Fixer API integration; all values are automatically converted to your primary currency for unified reporting.
- Customizable Categories - Define and organize spending categories (e.g., Streaming, Software, Utilities) to analyze where your money goes and identify cost-saving opportunities.
- Notification System - Receive alerts via email, Discord, Pushover, Telegram, Gotify, or webhooks for upcoming payments, cancellations, and subscription expirations.
- Logo Search & Upload - Automatically fetch subscription logos from the web or upload custom images to visually identify services at a glance.
- AI Recommendations - Get spending insights and cost-saving suggestions using ChatGPT, Gemini, or local Ollama models for personalized financial advice.
- Mobile-Optimized Interface - Fully responsive design that works on phones and tablets, allowing you to manage subscriptions on the go.
- Statistics & Dashboards - Visualize spending trends with charts and metrics, including yearly cost summaries and category breakdowns.
- OIDC/OAuth Login - Securely authenticate using external identity providers like Keycloak, Auth0, or any OIDC-compatible service.
- Self-Hosted Privacy - Your financial data stays on your server; no cloud uploads, no third-party tracking, and full control over backups and access.
Common Use Cases
- Building a personal finance dashboard for recurring expenses - A user tracks 15+ monthly subscriptions (Netflix, Spotify, GitHub Pro, cloud storage) and uses Wallos to visualize total spend, set reminders before renewal dates, and cancel unused services.
- Managing household expenses across multiple currencies - A family living in Canada with subscriptions in USD, EUR, and GBP uses Wallos to convert all charges to CAD and see their total monthly outflow in one dashboard.
- Problem: Missing subscription renewals → Solution: Automated notifications - A user was losing $20/month on forgotten trials; Wallos’s email and Discord alerts notify them 3 days before each payment, allowing timely cancellations.
- Team/workflow scenario: DevOps teams managing self-hosted financial tools - A home server admin deploys Wallos via Docker Compose on a Raspberry Pi, integrates it with their existing Nextcloud instance for authentication, and schedules daily currency updates using cron jobs.
Under The Hood
Wallos is a self-hosted subscription management tool designed to help users track expenses and financial commitments with a focus on simplicity and modularity. It offers a lightweight yet feature-rich solution for personal finance tracking, incorporating AI-driven insights to enhance user experience.
Architecture
Wallos adopts a monolithic architecture with clear separation between layers, supporting a modular design that promotes maintainability and scalability.
- The application follows a layered structure separating presentation, business logic, and data access concerns
- Modular organization with distinct directories for APIs, endpoints, and database interactions enhances code clarity
- Design patterns such as factory and strategy are applied in utility classes and external library integrations
Tech Stack
Built with PHP 8.3, Wallos leverages traditional web application practices and integrates system-level tools for functionality.
- The core is developed using PHP 8.3 with SQLite as the primary database and GD/Imagick for image handling
- Nginx and PHP-FPM are used for web serving, complemented by Docker for containerization and dumb-init for process management
- Cron jobs are implemented for scheduled tasks, while no formal testing framework is evident in the codebase
- The project uses a standard monolithic web architecture without modern frontend frameworks or extensive third-party libraries
Code Quality
Wallos presents a mixed quality landscape with some structured practices but notable gaps in testing and consistency.
- Type annotations are present, contributing to better code clarity and maintainability
- Error handling is implemented in key areas but lacks comprehensive coverage across the system
- Code organization exists but could benefit from more consistent naming and reduced duplication
- CI/CD pipeline is configured, indicating some level of automated workflow support
What Makes It Unique
Wallos distinguishes itself through its integration of AI-powered financial insights and a self-hosted approach that empowers users with control over their data.
- The tool uniquely combines subscription tracking with AI recommendations for smarter financial decisions
- Its embedded database architecture and modular API design allow for lightweight deployment without external dependencies
- The self-hosted model provides privacy and autonomy, setting it apart from cloud-based financial tools