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
zublo logo

Self-host zublo

v0.6.0

Self-hosted subscription tracker with AI-powered insights

BetaOpen SourceOther
Docker ComposeCompose file & guide
docker compose up -d
Updated2 days ago
LanguageTypescript
Setup difficultyEasy
Stars
185
Port
9597 (HTTP web UI and API)
Requires
PocketBase, SQLite
Docker
ghcr.io/danielalves96/zublo
Zublo dashboard demoSubscriptions viewCalendar viewStatistics viewChat view

What is zublo?

Zublo is a self-hosted personal subscription tracker designed for individuals and teams who want complete ownership of their recurring payment data. It provides a React-based web interface with dashboard, calendar, and statistics views for tracking subscriptions, due dates, and spending trends across multiple currencies. The built-in AI layer supports chat-based workflows and spending recommendations using pluggable LLM providers including Google Gemini, OpenAI, Ollama, and OpenAI-compatible endpoints like OpenRouter and Groq. Authentication uses TOTP-based two-factor authentication. The stack combines a React 18 frontend with PocketBase as the backend runtime, using SQLite for persistence. Deployment is Docker-first with a single container image published to GHCR, configured via Docker Compose with a named volume for data persistence. The project is licensed under Apache 2.0 and maintained by Daniel Luiz Alves.

zublo alternatives

All self-hosted alternatives to Bloated finance software → All self-hosted alternatives to closed SaaS trackers →

Should you self-host zublo?

zublo scores 45/100 on selfhost.directory (how scoring works) and ranks #38 of 62 in Personal Finance. It has 185 GitHub stars.

It shipped 6 stable releases in the past year. The latest, v0.6.0, came out on 22 September 2026. New versions land roughly every 3 days.

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

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

Features

  • AI Chat
  • Calendar View
  • Dashboard
  • Multi-currency Support
  • REST API
  • Statistics
  • Subscription Tracking
  • Two-factor authentication

zublo README

How to install zublo

Install zublo with Docker Compose

Docker and Docker Compose
Environment variables
PB_ENCRYPTION_KEY, PORT, PUID, PGID

Create a docker-compose.yml:

services:
  zublo:
    image: ghcr.io/danielalves96/zublo:latest
    container_name: zublo
    restart: unless-stopped
    ports:
      - "9597:9597"
    environment:
      PB_ENCRYPTION_KEY: "change-me-in-production"
    volumes:
      - ./zublo-data:/pb/pb_data

Start it:

docker compose up -d

Persist `/pb/pb_data` and set `PB_ENCRYPTION_KEY` in production. First registered user becomes initial admin.

How to configure zublo

  • PB_ENCRYPTION_KEYPocketBase encryption key for pb_data at rest (optional but recommended in production)

    values: 32-byte hex string (generate with: openssl rand -hex 32)

  • PORT9597Port exposed on the host
  • PUID1000UID of the user running the process inside the container
  • PGID1000GID of the user running the process inside the container

zublo releases & version history

More in Personal Finance

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…