OpenSource-Hub
O

Ocular

500 stars·Office Productivity·SHA-256 checksum verified

A self-hosted budgeting tool with beautiful dashboards, multi-language support, and privacy mode.

Smart Download

Visit Project Homepage

No installer available yet — head to the source repository

Self-hosted budget tracker with gorgeous charts and strong privacy focus.

Core Features

  • Handcrafted, no AI used (except translations)
  • Self-hosted, deploy via Docker in seconds
  • Light/dark themes, multi-language, all currencies
  • Installable as PWA, optimized for mobile
  • Import from Google Sheets annual planner, export JSON

What It Can't Do

  • Requires maintaining your own server and backups; does not support complex accounting like depreciation; may experience performance issues with very large datasets (tens of thousands of entries).

Use Cases

  • Personal expense and income tracking
  • Family budget planning across months/years
  • Small team or organization expense monitoring

Detailed Introduction

Ocular is a modern, self-hosted budgeting application designed for individuals and small teams. It allows you to track expenses and income across multiple years, visualize budgets with interactive charts including Sankey diagrams, and import data from Google Sheets. The application is fully customizable with light/dark themes, supports all common currencies, and can be run as a Progressive Web App (PWA) for mobile devices. It features user management, inline expression evaluation, carry-over budgets, and a privacy mode for public spaces. No AI was used during development (except translations), ensuring a handcrafted experience. Deploy via Docker in seconds.

Troubleshooting & FAQ (1)

Troubleshooting
How to fix 'strconv.ParseInt: parsing "": invalid syntax' panic when running Genesis v2 in Docker?

The panic occurs because the TOKEN_EXPIRATION environment variable is empty or missing. Set it to a valid integer (e.g., 3600) in your Docker configuration. For docker run: docker run -e TOKEN_EXPIRATION=3600 .... For docker-compose: add environment: - TOKEN_EXPIRATION=3600 under the service. This resolves the parsing error in config.go.

GitHub Issue #155

Tags

budgettrackingfinanceself-hostedpwaprivacy

Getting Started

1

Download installer

Click the button above to download the installer for your system

2

Install the software

Double-click the downloaded installer and follow the prompts

3

Run with Docker: docker run -d -p 3000:3000 --name ocular simonwep/ocular

4

Open http://localhost:3000 and create an admin account via the setup wizard

5

Start adding budget categories and recording transactions

Install Guide
  1. Run with Docker: docker run -d -p 3000:3000 --name ocular simonwep/ocular
  2. Open http://localhost:3000 and create an admin account via the setup wizard
  3. Start adding budget categories and recording transactions
File Integrity

Checksum not available

This project has not published a SHA-256 checksum on its GitHub Release page

SHA256 Checksum

No checksum available

Download directly from GitHub Releases and verify file integrity yourself

All SHA-256 checksums on this platform are extracted from the project's official GitHub Release page, without any modification. You can independently verify them on the GitHub Releases page.

Open Source Transparency

View GitHub Source
Environment Guide

Uninstall Info

Stop and remove the container: docker stop ocular && docker rm ocular; optionally remove the persisted data volume.

No Extra Dependencies

Ready to use after download. No additional runtime required.

Project Info
LicenseMIT
Last Updated2026-06-27 11:00:45
GitHub RepositoryOfficial Website

Having issues? Check the FAQ below

1 FAQ

Similar Projects