selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
subscription-manager logo

Self-host subscription-manager

3.2.11

Track and manage subscription expenses with calendar views

ReleaseOpen SourceMIT
Docker ComposeCompose file & guide
docker-compose up -d
Updated9 hours ago
LanguageTypescript
Setup difficultyEasy
Stars
358
Port
3000 (HTTP web interface)
Docker
dh1011/subscription-manager

What is subscription-manager?

Subscription Manager is a single-page web application for tracking and managing recurring subscriptions. It lets users add, edit, and remove subscriptions, view them on a calendar, and see weekly, monthly, and yearly cost summaries broken down by payment account. The app supports multiple currencies and uses Iconify for subscription icons. Notifications for upcoming payments can be sent via NTFY or Gotify, configured through a settings page. It runs as a Next.js application with a SQLite database, deployed via Docker Compose or manually with npm. The container listens on port 3000 and stores data in a mounted volume. No user authentication is built in; it's designed for personal use.

Should you self-host subscription-manager?

subscription-manager scores 47/100 on selfhost.directory (how scoring works) and ranks #32 of 62 in Personal Finance. It has 358 GitHub stars.

It shipped 8 stable releases in the past year. The latest, 3.2.11, came out on 27 October 2026. New versions land roughly every 8 days.

Setup is easy: most people get it running in one sitting. An official Docker image is available. It is MIT-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is Firefly III (82/100, 25 022 stars). It scores higher overall, so compare the two before you pick. See subscription-manager vs Firefly III side by side.

Features

  • Calendar View
  • Cost summaries
  • Custom Icons
  • Multi-currency
  • Notifications
  • Subscription CRUD

subscription-manager README

How to install subscription-manager

Install subscription-manager with Docker Compose

  1. Create a docker-compose.yml file with the following content:

    version: "3.9"
    services:
      app:
        image: dh1011/subscription-manager:stable
        ports:
          - "3000:3000"
        volumes:
          - ./data:/app/data
        restart: unless-stopped
    
  2. Create the data directory:

mkdir data
  1. Run Docker Compose:
docker-compose up -d
  1. The app will be available at http://localhost:3000.

Uses `stable` tag which tracks stable releases. Data persisted in ./data volume.

How to configure subscription-manager

  • TZTimezone for the application (e.g., America/Los_Angeles). Container uses UTC by default.

    Timezone for the application (e.g., America/Los_Angeles). Container uses UTC by default.

    values: IANA timezone names

subscription-manager releases & version history

More in Personal Finance

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…