# Wallos — Self-Hosted Personal Subscription Tracker

> Open-source subscription tracker to visualize recurring expenses, manage budgets, and stay on top of renewals.

## Install

Save as a script file and run:

# Wallos — Self-Hosted Personal Subscription Tracker

## Quick Use
```bash
docker run -d -p 8282:80 
  -v wallos_db:/var/www/html/db 
  -v wallos_logos:/var/www/html/images/uploads/logos 
  bellamy/wallos:latest
```

## Introduction
Wallos is a self-hosted web application for tracking personal subscriptions and recurring expenses. It provides a clean dashboard showing monthly and yearly costs at a glance, helping users identify spending patterns and avoid forgotten renewals.

## What Wallos Does
- Tracks all recurring subscriptions with cost, billing cycle, and renewal dates
- Calculates total monthly and yearly spending across all services
- Sends notifications before upcoming renewals via email or Gotify
- Supports multiple currencies with automatic exchange rate conversion
- Provides spending analytics with category breakdowns and historical trends

## Architecture Overview
Wallos is built with PHP and uses SQLite as its database, making it extremely lightweight. The application runs behind an Nginx web server inside a single Docker container. Logos are fetched automatically when adding a subscription, and all data stays local on your server.

## Self-Hosting & Configuration
- Deploy with Docker or Docker Compose using the official image
- Mount volumes for `/var/www/html/db` (database) and logos directory
- Configure SMTP or Gotify for renewal notifications
- Set your preferred currency in the web UI settings
- Optionally add Fixer.io API key for multi-currency conversion

## Key Features
- Single-container deployment with minimal resource usage
- Multi-user support with individual dashboards
- Payment method tracking and categorization
- API endpoint for integration with other tools
- Mobile-friendly responsive web interface

## Comparison with Similar Tools
- **Actual Budget** — full budgeting app; Wallos focuses specifically on subscription tracking
- **Firefly III** — comprehensive finance manager; Wallos is simpler and single-purpose
- **Maybe** — investment-focused; Wallos targets recurring expense visibility
- **GnuCash** — desktop accounting software; Wallos is web-based and subscription-oriented

## FAQ
**Q: Does Wallos support shared or family accounts?**
A: Yes, Wallos supports multiple users, each with their own subscription dashboard and settings.

**Q: Can I import subscriptions from a spreadsheet?**
A: Wallos supports CSV import for bulk-adding subscriptions.

**Q: What notifications does Wallos send?**
A: It sends reminders before subscription renewal dates via email, Gotify, Ntfy, or Discord webhooks.

**Q: Is an internet connection required after setup?**
A: No, Wallos runs fully offline. Internet is only needed for currency exchange rates and logo fetching.

## Sources
- https://github.com/ellite/Wallos
- https://wallos.org

---
Source: https://tokrepo.com/en/workflows/asset-1c85734c
Author: Script Depot